Perforce Software

P4Web "pathbrowser" Help Page

[Return to "How to Use P4Web"]

The Path Browser is where you'll spend most of your time in P4Web.

The Path 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:
  • Run: ...commands that will change the state of your client workspace:
    • Sync...
    • Submit...
    • Open files for edit...
    • Add new files...
    • Open files for delete...
    • Change file type...
    • Remove workspace files...
    • Integrate...
    • Resolve...
    • Lock opened files...
    • Unlock opened files...
    • Revert...
  • Show: ...different items in the Page Content of the Path Browser, or leave the Path Browser to show different screens entirely.
    • Opened files
    • Unsynced files
    • Unresolved files
    • Missing files
    • Opened/unchanged files
    • Changed/unopened files
    • Files matching...
    • Opened files -- all clients
    • Pending integrations
    • Submitted Changelists (relative to currently-displayed path)
    • Entire depot view (or Client View of Depot)
    • Workspace Mode
  • Go To: ...pages of other information accessible through P4Web:
    • Pending Changelists
    • Edit Current Client Spec
    • Edit Current User Spec
    • Labels
    • Server info
    • Configuration Settings
    • Client Specs
    • User Specs
    • Branch Specs

    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:

The page content contains the most useful information in the Path Browser. It contains a list of files and directories; the criteria that determine which files are displayed can be changed by selecting the proper option from the Show menu. In general, you'll see:

Current Path Name:

The current path name is prefixed with a label that is one of Client path, Depot path, or Workspace path, depending on the current "mode" in effect. Each path level that appears in the current path name is a link to the Path Browser page for that directory level.

Subdirectories:

One line for each subdirectory in the current path: The subdirectory name is a link to the Path Browser page for that subdirectory.

Files:

One line for each file being displayed. The viewing mode can be changed by the user; the default Path Browser viewing mode is Opened Files and shows:
  • All the files in the current directory.
  • All opened files in any of the subdirectories, regardless of which directory in which they reside.

Each file listed is prefixed by one or more file state icons:

  • Green icons denote files that are up-to-date:
    at head revision: (File has been Synced to the head revision; you have the most recent revision of the file.)
  • Orange icons denote files currently open in your client:
    opened for edit: (File is open for edit in your current client.)
    opened for add: (File is open for add in your current client.)
    opened for delete: (File is open for delete in your current client.)
    opened for integ: (File is open for integrate in your current client.)
    opened for integ: (File is open for branch in your current client.)
    locked: (File is locked in your current client.)
  • Red icons denote files that you won't be able to Submit until you've performed some action on the file:
    needs sync: (File needs Sync; you do not have the most recent revision of the file.)
    needs resolve: (File needs Resolve; someone else has made changes to the file during the time that you had the file open.)
  • Gray icons show information only; you have no immediate control over these icons:
    opened by other client(s): (File is also open on another client.)
    locked by another client: (File has been locked in another client.)
    head revision deleted: (The head revision of the file has been deleted.)
    in subdirectory: (The files listed are not in the current directory, but are in the displayed subdirectory relative to the current directory.)

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/pathbrowser.html#3 $