p4 fix
Link jobs to the changelists that fix them.
Syntax
p4 [g-opts] fix [-d] [-s status] -c changelist jobName ...
Description
The p4 fix
command links jobs (descriptions of work
to be done) to a changelist (a set of changes to files that does the work
described by a job).
If the changelist has not yet been submitted, the job appears on the
p4 submit
or p4 change
form for the
changelist to which it’s linked, and under normal circumstances, the
status of the job is changed to closed
when the changelist
is submitted. If the changelist has already been submitted when you run
p4 fix
, the job’s status is changed to a default
status (typically closed
) immediately.
To change a job status to something other than the default status
(typically closed
) when you submit a changelist, supply the
-s
option to p4 fix
, p4 submit
, or p4 change
.
Because described work can be fixed over multiple changelists, one job
can be linked to multiple changelists. Because a single changelist might
fix ten bugs, multiple jobs can be linked to the same changelist. You can
do this in one command execution by providing multiple jobs as arguments
to p4 fix
.
Options
|
The changelist to mark as fixed. |
|
Delete the fix record for the specified job at the specified changelist. The job’s status will not change. |
|
Upon submission of the changelist, change the job’s status to
status, rather than the default value If the changelist to which you’re linking the job been
If the changelist is To leave a job unchanged, use the special status of
|
|
See Global options. |
Usage notes
Can File Arguments Use Revision Specifier? | Can File Arguments Use Revision Range? | Minimal Access Level Required |
---|---|---|
N/A |
N/A |
|
- Because the format of jobs can be changed from site to site, it is
possible that the jobs on your system no longer have a
Status
field. If so, you can still link jobs to changelists withp4 fix
, but Helix Core Server will not change any of the job fields' values when the changelist is submitted. - You can change a fixed or unfixed job’s status at any time by editing
the job with
p4 job
. - Another way to fix (or unfix) a job is to add it to (or delete it
from) the
Jobs
field of an unsubmitted changelist’sp4 submit
orp4 change
form. - You can’t
p4 fix
a job to the default changelist; instead, add the job to theJobs
field of the default changelist’sp4 submit
form when submitting it to the depot. -
If you use
p4 fix -s status
on a job, and then use the-s
option withp4 submit
orp4 change
, theJobs
field of the changelist’s form will also require a status value (the default value being the one specified byp4 fix -s status
). The job(s) will be assigned the specified status upon successful submission of the changelist. If no status value is specified in the form, the error message:Wrong number of words for field 'Jobs'.
is displayed.
p4 fix -s status,
p4 submit -s
, andp4 change -s
are intended for use in conjunction with defect tracking systems.Under normal circumstances, end users do not use these commands, and use
p4 submit
andp4 change
without the-s
option. In this case, only the job number is required in theJobs
field, and each job’s status is set to a default value (typicallyclosed
) on completion of the submit.
Examples
|
Mark two jobs as being fixed by changelist 201. If changelist 201 is still |
|
Mark Requires use of the |
Related commands
To add or delete a job from a pending changelist |
|
To add or delete a job from the default changelist |
|
To view a list of connections between jobs and changelists |
|
To create or edit a job |
|
To list all jobs, or a subset of jobs |
|
To change the format of jobs at your site (superuser only) |
|
To read information about the format of jobs at your site |
|