Perforce Command Reference:   [Index]  [Prev] [Next]


p4 job

Synopsis

Create or edit a job (defect) specification

Syntax

p4 [g_opts] job [ -f ] [ jobName ]
p4 [g_opts] job -d [ -f ] jobName
p4 [g_opts] job -o [ jobName ]
p4 [g_opts] job -i -f

Description

'p4 job' creates and edits job specifications using an ASCII form. A job is a defect, enhancement, or other unit of intended work. The 'p4 fix' command can associate changelists with jobs.

With no arguments, 'p4 job' creates a blank job specification form and invokes the user's editor. When the form is saved, a job name of the form jobNNNNNN is created. If a jobName is given on the command line either that named job will be created or, if the job already exists, the job can be modified.

As jobs are entered or updated, all fields are indexed for searching by 'p4 jobs'. Text fields are broken into individual alphanumeric words (punctuation and whitespace are ignored) and each word is entered, case folded, into the word index. Date fields are converted to an internal representation (seconds since 1970/01/01 00:00:00) and entered into the date index.

The -d flag deletes the named job and any associated fixes.

The -o flag causes the named job specification to be written to the standard output. The user's editor is not invoked.

The -i flag causes a job specification to be read from the standard input. The user's editor is not invoked.

The -f flag allows otherwise read-only fields to be set.



Perforce Command Reference:   [Index]  [Prev] [Next]


Copyright 1998 Perforce Software.
Contact us at [email protected]
Last updated: 06/14/98