P4Web User Guide - Using The Tree view

P4Web Release 2005.1 User Guide
[Getting Started] [How To...] [Browser Tips] [Glossary] [Road Map]

Using The Tree view

The Tree view is the page P4Web shows you when you first connect. It's where you'll spend most of your time in P4Web. You can use it to navigate through path hierarchies and run commands that affect all the files in the current path at once. (Note that if you are using P4Web in Viewer mode instead of Standard mode, only a subset of commands are available to you.)

"Show/Hide Recent Activity"

The control panel offers menus and shortcut buttons, described below. The "Show Recent Activity" button can be used to turn on a display of the most recent changelists affecting the files in the current path.

The current path is shown at the top of the tree. Each level in the current path heading is a link. Use these links to navigate back up the path hierarchy. Files and subdirectories in that appear beneath the heading are links to directories and files. Click on those links to navigate down the path hierarchy.

You can browse either depot or workspace paths in the Tree view. See Depot Browsing vs. Workspace Browsing to find out what the difference is, why each is useful, and how to switch between them.

Note that even though the Tree view may display individual files, you can't run commands on individual files from here. You must click on the individual file to run commands on it, using the File view.

Files shown in the Tree view have state icons showing their current state in the depot and in your workspace; see below for a key to their meanings.

File operation menu

The pulldown menu at the top of the page allows you to work on files in the current path. You control whether commands are run on all or selected files in the current path by either selecting a directory or a file before running the command.

Sync... lets you synchronize your workspace files with newer (or older) depot files.
Remove from workspace is how you remove files from your workspace without affecting depot files.
Open for edit... makes your workspace files writable so you can work on them.
Open for add... is how you add new files to the depot.
Open for delete... is how you delete depot files; it also removes files from your workspace.
Revert... can be used to throw away your workspace changes and close files without submitting them to the depot.
Change filetype... opens files so they can be submitted to the depot with a different filetype.
Integrate... lets you open files so changes from other files can be merged into them. It also lets you branch new files.
Resolve... is how you merge changes into your opened files.
Lock... can be used to prevent other people from updating depot files before you do.
Unlock... releases locks on your opened files.

Note: If you are in workspace browsing mode, the Tree will display all the files in your workspace, including those not managed by Perforce. (You'll recognize the Perforce-managed files by the icons that appear.) With one exception, the commands in the pulldown menu operate on Perforce-managed files only. The exception is Open for add... which lets you add new files to Perforce.

File filter

The file filter allows you to display various information about files in the current path (that is, files at or below the current path level). After making filter selections, click Filter to display the results.

You can select the following options from the first filter pull-down menu:
- No Filter is the default Tree display. It shows files present at the current path level, plus any files you have open in subdirectories of the current path.
- Hide files in subfolders only shows directories, not files within them.
- Opened files - all clients - shows files opened in other client workspaces as well as in your own. (To see who has a particular file opened, click on the file name. This takes you to the File Browser page, where file state details are displayed.)
- Opened unchanged files - shows files you have opened but have not changed.
- Changed unopened files - shows files you have changed without having opened them first with Perforce.
- Submitted Changelists - lists all submitted changelists affecting files in the current path, with links to more info about them.
- Files missing from workspace - shows files that were synced in your workspace but are missing now. (That is, they were removed by something outside of Perforce's control.)
- Unsynced files - shows your workspace files that are not synced to head revisions.
- Unresolved files - shows the files that need resolving, either because you have them opened for integrate, or because you re-synced files after opening them for edit.
The Files matching... option lets you find files whose names match a pattern you specify. Click Include subfolders to search in directories below the current path.

If you in depot browsing mode, you have two additional filter options:

Show deleted files - shows files that have been deleted in the depot.
Show only files in client view - restricts the files that you see in the tree to only those in your client view.

Shortcut Buttons

The Path Browser's shortcut buttons give you quick links to these common operations:

Displays the Tree view.
Sync files in this path to head revisions. This copies updated files from the depot into your workspace.
Lets you submit your default changelist. You can select all or some of the files open in the default changelist, enter a change description, and submit the files to the depot.
Reverts all files you've opened in the current path, but have not changed since opening. (This will not revert any files opened for add or delete, or on which you have done a resolve.)
Turns display of recent activity on or off in the control panel.
Cancels your last server request before it is finished.

File state icons

These icons denote files that are up-to-date:
The file in your workspace file is in sync with the head revision of the depot file.
The file has been deleted in the depot and is not present in your workspace. (You must have "Show deleted files" set to see this state.)
These icons denote files open in your current client workspace:
The file is open for edit in your workspace.
The file is open for add in your workspace.
The file is open for delete in your workspace.
The file is open for integrate in your workspace.
The file is open for branch in your workspace.
The file is locked in your workspace.
These icons denote files that you won't be able to submit until you've performed some action on them:
The file needs to be re-synced before you can submit it.
The file needs to be resolved with changes either from a later revision of the same file or from the file that's being integrated to it.
These icons show information that is independent of the state of your workspace:
The file is also open in another client workspace.
The file has been locked in another client workspace.
The head revision of the file has been deleted.
The file lives in a subdirectory below the current path.
The file is not mapped in your client view. (You must have "Show entire depot view" set to see this state.)

File state details

Each file shown in the Tree view is followed by state details that look like:

#[have]/[head] [filetype]

For example, the file state "#4/6 text+x" means that the revision you have in your workspace is #4, the head revision of the file is #6, and its filetype is "executable text".