#!perl -w
 
# Copyright (C) 1997 Capella Computers Ltd.
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
# 
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
# 
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
# :FILE:
# Start working on a new job.
 
use strict;
use English;
use P4;
 
# Takes (optional) job id.
sub usage {
    P4::crash("Usage: p4wb [<job>]");
}
 
# Parse command line.
my $job;
if ($#ARGV < 0) {
    $job = P4::current_job();
} elsif ($ARGV[0] eq '-h') {
    usage();
} elsif ($ARGV[0] =~ /^\d+$/) {
    $job = shift(@ARGV);
}
if ($#ARGV >= 0) {
    usage();
}
 
# Verify quick pre-conditions.
P4::verify_current_user(0, 'integ');
 
# Lock depot to avoid race conditions.
P4::lock($job, 'p4wb');
 
# Obtain the job record.
my %record = P4::job_record($job);
 
# Verify pre-conditions.
my $status = $record{status};
P4::verify_job_status($job, \%record, 'new');
 
# This helps in case something goes wrong.
my $user = P4::current_user();
$record{user} = $user;
$record{status} = '_work';
P4::update_job($job, \%record);
 
# Create a branch for working on this job.
my $retry = $record{retry};
my $branch = "$user-$job-$retry";
P4::create_branch($branch, "for $user to work on $job",
		'//depot/baseline/...', "//depot/$user/$job-$retry/...");
 
# Create a new change for populating the branch.
my $change = P4::create_change($user, "Begin $job-$retry by $user.");
 
# Integrate the branch (thus populating it). In this case, bug #350 does
# not bother us, since we'll submit the change in a moment anyway.
$::OUTPUT_AUTOFLUSH = 1;
print "### Create development branch ...\n";
P4::integrate_branch($branch, $change, 'quick');
 
# Submit the change.
$::OUTPUT_AUTOFLUSH = 1;
print "### Submit creation of development branch ...\n";
$change = P4::submit_change($change);
 
# This enables tracking job history.
P4::create_fix($change, $job);
 
# Finally, we need to get the branch files.
$::OUTPUT_AUTOFLUSH = 1;
print "### Get development files ...\n";
P4::get_files("//depot/$user/$job-$retry/...");
 
# Create the change for working on this branch.
$change = P4::create_change($user, "Work on $job-$retry by $user.");
 
# Again, this enables tracking job history.
P4::create_fix($change, $job);
 
# Update the job record with the change number, and set its status to 'work'
# to indicate it is now safe to work with.
$record{dev_chg} = $change;
$record{dev_client} = P4::current_client();
$record{status} = 'work';
P4::update_job($job, \%record);
 
# Release obtained locks.
P4::unlock();
 
# Notify caller.
print "Work on job $job (attempt #$retry) by $user has began.\n";
 
# Be nice.
1;