History

Whenever a new version of a file is checked into the Perforce service, a history record is created. Begin browsing the history of changes by clicking the History link in the main toolbar.

The History page

When you are viewing a particular file or directory, clicking the History tab displays the history of changes for that location in the depot.

The History page for a specific depot location

Range filter

The Range field's syntax summary dropdown. The Range field lets you filter the list of changes for the depot path being viewed. When you click the Range field, a dropdown syntax guide appears providing sample history filtering expressions.

The expressions that can be used within the Range field include:

  • @0,@now (the default): displays all history entries for the current depot path.

  • @80,@90: displays all changes between 80 and 90.

  • @80: displays all changes up to change 80.

  • @=80: displays only change 80. Change 80 might not involve the current depot path, so there may be no history entry to display.

  • @label-name: any changes represented by label label-name.

  • @2014/11/30: displays all changes up to November 30, 2014.

  • @2014/11/30,@now: displays all changes from November 30, 2014 to now.

File History

A file's history presents each version of a file that the Perforce service knows about, including the change number, userid, change description, time ago, along with Open and Download buttons.

The History page for a file

Swarm also displays contributing history when available, such as when a file has been renamed, or integrated from another location in the Perforce service.

The trashcan icon represents a deleted version

If an entry in the history represents a deleted revision, the Open and Download links are replaced with a trashcan icon to indicate that this version is no longer available.

Remote depot history

When your Perforce service has a remote depot configured, you can browse the contents of the remote depot, but remote depots do not share their change history. If you attempt to view the history of a file provided by a remote depot, Swarm displays: