Perforce Software

P4Web "filebrowser" Help Page

[Return to "How to Use P4Web"]

The File Browser allows you to view detailed information on a file's revision history, including changes from one revision to the next.

You get to the File Browser by clicking on an individual file, whether in the Path Browser or in a changelist description.

The File Browser page consists of five parts:

The Logo Bar:

Every P4Web page starts with a logo bar. To help you keep track of where you are in P4Web, the black bar across the top of the screen displays the current P4Web page name, the current user name, client name, and port address.

The Recent Activity Bar:

The Recent Activity Bar displays the five most recent changes affecting files in the current path (or file) being browsed. The oldest change is to the left; the most recent change is to the right.

Clicking on any of these changelists will bring up a page that lets you view a description of the change and a list of affected files.

The Control Bar:

The control bar consists of a menu bar, an icon bar, and the version ID.

Menu Bar:

The menu bar contains three lists:

Icon Bar:

The icon bar holds a row of icons for the most frequently-used commands. Many of these commands are identical to the ones in the menu bar. Where they differ, they tend to be shortcuts for the full-fledged commands in the menu bar. For instance, the Run -> Sync... command brings up a page which allows you to select several options for the Sync, whereas the Sync icon bypasses the "options screen" and syncs all files at the current directory level and below.

The available icons, and their actions, are as follows:

  • : (Sync Preview - Preview what the Sync button would do.)
  • : (Sync - Re-sync all files at the current directory level and below.)
  • : (Resolve - A safe Resolve of all files at the current directory level and below.)
  • : (Lock opened files - Lock all opened files at the current directory level and below.)
  • : (Submit default changelist)
  • : (Revert unchanged files - Revert all files you've opened, but have not changed since opening, at the current directory level and below. Only the files you've made changes to after opening them will remain open.)
  • : (Hide files in current path: Not Yet Supported)
  • : (Edit current client spec)
  • A Help button. (Get Help on the current screen)

Version ID:

The version of the P4Web executable you're running will appear to the right of the screen, just beneath the Menu Bar. Perforce technical support personnel may ask for this information to help you with problems you may encounter.

Page Content:

Every File Browser page shows basic information about the file plus specific information as a function of the current viewing mode.

Common To All Modes:

The following basic information is displayed in all viewing modes:

Viewing Modes:

The five viewing modes in the File Browser are:

File log:

  • Clicking on Show -> File log displays the file's filelog, or revision history. This is also the default File Browser mode displayed when you click on a changelist.
  • Clicking on a revision number next to a change will display the diffs between the selected revision and the previous revision. The command-line equivalent will be displayed in Bold text above the actual diff.
  • Clicking on a changelist number will provide you with the description of the changelist, including a list of all files affected by the changelist.
  • This is a quick and easy way of telling what files were changed in which changelists, as well as examining the changes in each revision of a file's history.

File text (head revision):

  • Clicking on Show -> File text (head revision) will display the text of the head revision, or latest version of the file, as it's stored in the depot.
  • If you've checked out a file for editing, this will show you the file as it existed when you checked it out, (or, if someone else has submitted a changelist affecting this file, the most recently submitted version of the file).

File text (local file):

  • Clicking on Show -> File text (local file) will display the text of the file as it presently exists on your client workspace; that is, the file as it exists on your local hard drive.
  • If you've checked out a file for editing, this will show you the file and any changes you've made to it subsequent to checking it out.

Workspace vs. client rev diffs:

  • Clicking on Show -> Workspace vs. client rev diffs will run a diff on the file as it's stored in your workspace and the revision you checked out.
  • (This is most commonly used to check the the difference between what you currently have on your local workspace vs. what you checked out for editing.)

Client vs. head rev diffs:

  • Clicking on Show -> Client vs. head rev diffs will run a diff on the file at the time you checked it out against the latest revision stored in the depot. (If you've already got the head revision, there will be no difference.)
  • (This is most commonly used when someone's submitted changes to a file you're editing, and you want to see what they did to the file in the absence of your changes.)

Workspace vs. head rev diffs:

  • Clicking on Show -> Workspace vs. head rev diffs will run a diff on the file as it's stored in your workspace against the head revision of the file.
  • (This is most commonly used when you want to compare your copy of the file, including your edits, against a revision someone else submitted to the depot while you had the file checked out.)

Submitted changelists

  • Clicking on Show -> Submitted changelists will take you to a condensed view of all changelists affecting the current file.
  • This is equivalent to the Show Submitted Changelists command.

Page Footer:

Every P4Web page ends with a copyright message; if you don't see the copyright message, it's likely that the page is still being rendered by your browser, that transmission of the page was somehow interrupted, or that you may have found a bug in P4Web.

[Return to "How to Use P4Web"]


Copyright 2000 Perforce Software
$Id: //depot/r99.2/p4-doc/manuals/p4web/help/filebrowser.html#3 $