Perforce 2006.1 Command Reference | ||
<< Previous Chapter p4 branches |
Table of Contents Index Perforce on the Web |
Next Chapter >> p4 changelist |
p4 change brings up a form for editing or viewing in the editor defined by the environment or registry variable P4EDITOR. When no arguments are provided, this command creates a new, numbered changelist.
Changelist numbers are assigned in sequence; Perforce may renumber changelists automatically on submission in order to keep the numeric order of submitted changelists identical to the chronological order.
You can use p4 change changelist# can be used to edit the description of a pending changelist, and to view the fields of a submitted changelist.
If p4 submit of the default changelist fails, a numbered changelist is created in its place. The changelist must be referred to by number from that point forward.
The command p4 changelist is an alias for p4 change.
Field Name |
Type |
Description |
---|---|---|
Change: |
Read-only |
Contains the changelist number if editing an existing changelist, or new if creating a new changelist. |
Client: |
Read-only |
Name of current client workspace. |
User: |
Read-only |
Name of current Perforce user. |
Status: |
Read-only value |
pending, submitted, or new. Not editable by the user. The status is new when the changelist is created, pending when it has been created but has not yet been submitted to the depot with p4 submit, and submitted when its contents have been stored in the depot with p4 submit. |
Description: |
Writable, |
Textual description of changelist. This value must be changed before submission, and cannot be changed after submission, except by the Perforce superuser. |
Jobs: |
List |
A list of jobs that are fixed by this changelist. The list of jobs that appears when the form is first displayed is controlled by the p4 user form's JobView: setting. Jobs may be deleted from or added to this list. |
Files: |
List |
The list of files being submitted in this changelist. Files may be deleted from this list, and files that are found in the default changelist can be added. |
-d |
Delete the changelist. This is usually allowed only with pending changelists that contain no files, but the superuser can delete changelists under other circumstances with the addition of the -f flag. |
-f |
Force flag. Allows the description of a submitted changelist to be edited. Editing a submitted changelist requires admin or super access. Superusers and administrators may also overwrite Read-only fields when using the -f flag. |
-f -d |
Forcibly delete a previously submitted changelist. Only a Perforce administrator or superuser can use this command, and the changelist must have had all of its files removed from the system with p4 obliterate. |
-o |
Write a changelist description to standard output. |
-i |
Read a changelist description from standard input. Input must be in the same format used by the p4 change form. |
-s |
Allows jobs to be assigned arbitrary status values on submission of the changelist, rather than the default status of closed. On new changelists, the fix status is displayed as the special status ignore. (If the status is left unchanged, the job is not fixed by the submission of the changelist.) This option works in conjunction with the -s option to p4 fix, and is intended for use by Perforce Defect Tracking Integration (P4DTI). |
g-opts |
See the Global Options section. |
To submit a changelist to the depot | |
To move a file from one changelist to another | |
To remove a file from all pending changelists | |
To list changelists meeting particular criteria | |
To list opened files | |
To list fixes linked to particular changelists | |
To link a job to a a particular changelist | |
To remove a job from a particular changelist |
p4 fix -d |
To list all the files listed in a changelist |
p4 opened -c changelist# |
To obtain a description of files changed in a changelist |
p4 describe changelist# |
Perforce 2006.1 Command Reference | ||
<< Previous Chapter p4 branches |
Table of Contents Index Perforce on the Web |
Next Chapter >> p4 changelist |