Displaying Submitted Changelists

You can see the history of any file or path in a Perforce depot by displaying its submitted changelists. The Show->Submitted changelists command is available in the control panel of both the Path Browser and the File Browser:

• When used from the File Browser, Show->Submitted changelists lists all the changelists that affected the current file, most recent first.

• When used from the Path Browser, Show->Submitted changelists lists all the changelists that affected files in the current path, most recent first.

Note that in the case of an individual file, the default File Browser display (Show->Filelog) can be used to show the complete history of the file, with slightly more detail.

Use the "Next" button to page down through the list of submitted changelists, showing progressively older changelists. You can enter a number of changelists to display on each page. To page back through the list, use your browser's "Back" button.

Integrated Changes

By default, only changelists associated directly with the current file or path are shown. For example, if your current path is //depot/projects/titan/index.html, the submitted changelists page shows the changelists that involve revisions of the //depot/projects/titan/index.html file.

The "show integrated changes" option expands the changelists shown to include those known to have been integrated to the current file or path. For example, if your current file is //depot/projects/titan/index.html, the "show integrated changes" option will cause these submitted changelists to be displayed:

• Changelists that involve revisions of the //depot/projects/titan/index.html file

• Changelists that involve any other file revisions that were integrated to the //depot/projects/titan/index.html file.

Currently there are some limitations to the "show integrated changelists" option:

• The option only takes effect when you click the "Next" button; the first page of submitted changelists shown by Show->Submitted changelists always shows only the changelists involving the current file or path directly. To see the most recent integrated changelists for the current file or path, go to the bottom of the first page of submitted changelist, enter an arbitrarily high number in the changelist field, click the "show integrated changelists" button, and click "Next".

• You can't see any integrated changelists lower than those shown on the page that includes the first changelist number that directly affected the current file or path. For example, assume the current file is //depot/projects/titan/index.html and it was created with changelist 14560: the last page of submitted changelists you can display, including integrated changelists, is the page on which changelist 14560 is listed. Even though there are other file revisions in considerably earlier changelists which may have been integrated into //depot/projects/titan/index.html, they will not be displayed unless they fit on the same page as changelist 14560.