Changelists
Changelists are the basic unit of versioning work in Perforce. A changelist is a list of files, their revision numbers, and the changes made to those files. See “History” for more information about browsing changelists.
Changelist Display
View a specific changelist by clicking on a linked changelist number, or by visiting the URL:
http://myswarm/changes/changelist number
When Swarm displays a change, the presentation is similar to:
The changelist display includes:
-
The avatar and userid of the user who made the change
-
The time the change was made
-
The common depot location containing all the files included in the change
-
The description of the change
-
A list of jobs that this change fixes, if any. You can add jobs and unlink jobs here.
-
The list of files included in the change, including any folders between the common depot location and the file, and the file's verion number.
-
A tab to review any comments made regarding the change, or any of its files.
Each file is presented in a diff display, showing you whether the file was added, modified, or deleted. For text-based and image files, Swarm can display any changes made within the file. For changes with only a single file, the diff display is the default; otherwise each file is listed. Click the filename to see the diff display. See “Diffs” for more information.
The button indicates the current state of this change; no Review record has been created. Clicking on starts a code review for this change. For more information, see: “Start a review”.
When a file in a changelist has one or more associated comments, an icon appears near the far right of the file's entry.