Editing a Pending Changelist

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.

To view a pending changelist,

• Select the Pending tab and then select one of the changelists on that page, or

  "Submit default changelist"

• Click the "Submit default changelist" shortcut button.

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.) For more information about job status, click here.

• 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 user and one pending changelist.) The checkboxes indicate which of the files will be used for the action button you choose, described below.

The Pending Changelists 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:

• Create Changelist:
  Saves the information you've entered in a numbered pending changelist which you can edit or submit later. This action is available when you are editing the default changelist.

• Update Changelist:
  Saves the current pending changelist with the information you've entered. This action is available when you are editing a numbered pending changelist.

• Submit:
  Sends the selected files to the depot where they will be stored as new revisions and makes a permanent record of this submitted changelist. This action is available when you are editing a pending changelist that has files associated with it.

  Next to the Submit button, there is a leave files open checkbox. If you select this checkbox, your files will be checked back out after you submit, and re-opened for edit.

• Move to Changelist:
  Takes the files you've selected off the current changelist and puts them in the changelist you picked in the "Move to Changelist" field. Note that any changes you made to the Description or Jobs fields will be ignored when you click this button. This action is available when you are editing a pending changelist, and you have more than one pending changelist in your workspace.

• Delete Empty Changelist:
  Deletes the pending changelist from your workspace. This action is available when you are editing a numbered pending changelist that has no files associated with it.

• Revert Files:
  Overwrites the workspace files you've selected with copies from the depot, and removes the files from your pending changelist. If you had the files locked, revert unlocks them. With "only if unchanged" checked, only the unchanged files you have opened for edit will be reverted. If you want to revert files you've changed, or files opened for another reason, choose "ALL selected files". Warning: file changes you've made in your workspace will be lost when you revert files! This action is available when you are editing a pending changelist that has files associated with it.

Note about sharing workspaces

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:

• only the files opened by the current user can be submitted
• only the files opened by the current user are visible in the Pending Changelist form

This can be somewhat confusing.