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.
- Show:
...different items in the
Page Content area of the
file browser. Displayable items include:
- File log
- File text (head revision)
- File text (local file)
- Workspace vs. client rev diffs
- Client vs. head rev diffs
- Workspace vs. head rev diffs
- Submitted changelists
- Go To:
...different sets of information accessible through P4Web.
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:
- Client (or Depot) view file:
The full path to the file, as expressed in depot syntax.
Each component of the path is a link to a directory
level in the Path Browser.
- Type:, Have:, and Head:
The file's
filetype,
the number of the revision you have in your client
workspace, and the number of head (latest) revision
in the depot.
- Workspace:
The full path to the file, expressed in local syntax.
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.