The Pending Changelist page allows you to create a new pending changelist, edit a pending changelist, move files between pending changelists, and submit opened files in a pending changelist.
Having multiple pending changelists is a way to organize your opened files into logical groups. When you submit a pending changelist, all the files associated with that changelist are submitted at the same time and a permanent record is made of the event in the depot.
You can get to the Pending Changelist page:
"Submit default changelist" |
The following fields are displayed on the Pending Changelist page:
- Change: The changelist number. This is a read-only field. Its value is "new" if you are editing the default changelist. Numbered pending changelists are assigned a changelist number when you create them. (Note that when you submit a pending changelist, it may be renumbered. You have no control over the numbering process.)
- Date: The current date and time. (Read-only.)
- Client: Your client name. (Read-only.)
- User: Your user name. (Read-only.)
- Status: Numbered pending changelists have a status of "pending". The default changelist has a status of "new". (Read-only.)
- Description: A description of the change you are making to the files being submitted. This description will be stored permanently in the Perforce depot when you submit the changelist. You don't have to itemize the files in your description; they are already listed in the "Files" field.
When you first edit the changelist, this field will contain the text:
<enter description here>You must change this text before you can submit the changelist.
- JobStatus: New status to assign to jobs listed in the "Jobs" field of this changelist. The default is "closed". (Optional.)
- Jobs: Perforce jobs to update when this changelist is submitted. If you have a "Jobview" value set in your user spec, jobs matching that jobview will automatically appear in this field. (Optional.)
- Files: The files that are opened by you, the current user, and that are associated with this changelist. (Each open file in your workspace is associated with only one pending changelist.) The checkboxes indicate which of the files will be used for the action button you choose, described below.
The Pending Changelist page offers you several actions to take. The files used in the action will be those checked in the file list shown on the page. At the end of the page you'll see buttons that can execute those actions:
If you decide not to take any of the available actions you can use the "Return to Browser" shortcut button or Go To->Path Browser to leave the Pending Changelist page.
P4Web assumes your workspace is used by only one user, the current user. (That's the user name you see in the P4Web control panel at the top of each page.) In the rare case where more than one user is using the same client workspace, you could end up with files opened by more than one user. However:
This can be somewhat confusing.