Checking in changes (working with changelists)

To check in changes you have made to the files in a project, you submitClosed To send a pending changelist into the Helix Server depot for processing. the changelistClosed A list of files, their version numbers, the changes made to the files, and a description of the changes made. A changelist is the basic unit of versioned work in Helix Server. The changes specified in the changelist are not stored in the depot until the changelist is submitted to the depot. See also atomic change transaction and changelist number. containing the files. Use changelists to structure your changes. For example, use a changelist to group the changes required to fix a bug or add a feature. This approach enables you to keep the revision history of your project files coherent.

To check in changes:

  1. In the P4 Pending Changelists view, right-click the changelist that contains the files you want to check in and choose Submit...
  2. The Perforce Change Specification dialog is displayed.

  3. Enter a description of your changes. If there are files you do not want to submit, un-check them. Any files that you do not submit remain checked out.
  4. Click Submit. Your changes are submitted.
  5. To verify:
    1. In the P4 Submitted Changelists view, click the Refresh button Refresh button image on the view toolbar to display the newly submitted changelist.
    2. Double click on the newly submitted changelist to display the changelist details, an example is shown below:

Verify Changelist Submitted image

To create a changelist, click New changelist icon image in the P4 Pending Changelists view.

To move files among changelists, select the files in the P4 Pending Changelist view and drag them to the target changelist.

To compare the state of the project in your workspace with the version in the depot, right-click the project in the navigator and choose Team > Check Consistency... P4Eclipse displays files you have added to or deleted from the project, enabling you to make sure that you check in the correct project files, as shown in the following image. Click OK to mark files for add or delete as required.

Image showing the Consistency Check Results dialog

When you submit a changelist, you might encounter file conflicts that require resolution. Conflicts can occur, for example, if another user checks in changes after you check a file out. Perforce requires you to decide how the two differing versions of the file are resolved. For more details, see Team Development and Resolving Conflicting Changes.

Changelists submitted by you and other users are listed in the P4 Submitted Changelists view. You can filter this view to display only the changelists pertaining to a specified user, path, and workspace. To clear the filter, click Eraser icon image.