|
Synopsis
Link jobs to the changelists that fix them
Syntax
p4 [g-opts] fix [ -d ] -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, a job will appear 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 will be changed to closed when the changelist is submitted. If the changelist has already been submitted by the time you run p4 fix, the job's status will be set to closed as well.
Since described work may be fixed over multiple changelists, one job may be linked to multiple changelists. Since a single changelist might fix ten bugs, multiple jobs can be linked to the same changelist. The latter can done in one command execution by providing multiple jobs as arguments to p4 fix.
Options
|
-d
|
Delete the fix record for the specified job at the specified changelist. The job's status will not change.
|
|
g_opts
|
See the Global Options section.
|
Usage Notes
Can File Arguments Use
Revision Specifier?
|
Can File Arguments Use
Revision Range?
|
Minimal Access Level Required
|
|---|
|
N/A
|
N/A
|
open
|
- 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's p4 submit or p4 change form.
- You can't p4 fix a job to the default changelist; instead, add the job to the Jobs: field of the default changelist's p4 submit form when submitting it to the depot.
- Since 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 with p4 fix, but Perforce will not change any of the job fields' values when the changelist is submitted.
- When the Status: field remains, its value will always be changed to closed when changelists to which the job is linked are submitted, even when this field's format has been changed to exclude closed as a possible value. Please see the p4 jobspec page for more information.
Examples
|
p4 fix -c 201 job000141 job002034
|
Mark two jobs as being fixed by changelist 201.
If changelist 201 is still pending, the jobs' status will be changed to closed when the changelist is submitted.
|
Related Commands
|
To add or delete a job from a pending changelist
|
p4 change
|
|
To add or delete a job from the default changelist
|
p4 submit
|
|
To view a list of connections between jobs and changelists
|
p4 fixes
|
|
To create or edit a job
|
p4 job
|
|
To list all jobs, or a subset of jobs
|
p4 jobs
|
|
To change the format of jobs at your site (superuser only)
|
p4 jobspec
|
|
To read information about the format of jobs at your site.
|
p4 jobspec -o
|
|