Editing A Pending Changelist

The Edit 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 Edit Pending Changelist page:

• By selecting a changelist from the Go To->Pending Changelists page, or
• By clicking Run->Submit, or
• By clicking on the Submit Default Changelist icon.

The following fields are displayed on the Edit Pending Changelist page:

• Changelist: 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.)

• 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: Information about what is being changed. This information will be stored permanently in the Perforce depot when you submit the changelist.

  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.

• Jobs: Perforce jobs to close 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.

• Files: The files associated with this changelist. (Each open file in your workspace is associated with one and only one of your pending changelists.) The checkboxes indicate which of the files will be used for the action button you choose below, described below.

The Edit 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:

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

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

• Submit Changelist:
  This action is available when you are editing a pending changelist or submitting a changelist. Clicking this button sends the selected files to the depot and makes a permanent record of this changelist.

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

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

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 Edit Pending Changelist page.