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

P4Web User Guide - Using the File view

The File view enables you to display detailed information about a file, and to work on that file. You get to the File view by clicking the file name portion of any of the files listed in the Tree view. You can also get to the File view by clicking any of the file links list in the Changelist Description page, the Submit Changelist page, or the Pending Changelist page. (If you are using P4Web in Viewer mode, some of the information, links and menu items described here won't be visible to you.)

The current file's full depot path and name appear below the control panel. Each component of the path is a link to a directory level in the Tree view.

Detailed state information follows the current file heading:
Type, Have, and Head The file's filetype, the revision you have in your client workspace, and the head revision in the depot, respectively.
Workspace

Displays the location of the file in your workspace and gives you a browser link to it. If you click on this link, your browser opens the workspace file, allowing you to view work in progress. The file must be local to the machine running the browser. Some browsers do not support this functionality.

Additional state information is displayed if your workspace file needs to be synced, if you and/or anyone else has the file opened, if you need to resolve the file, and so forth.

File state Displays Perforce state information for the current file.
Revision History Displays the complete history of the file and provides links to previous file version information and content. (Revision History is the default File view display.)
Changelist description/action Displays a summary list of all changelists submitted to this file, with links to the corresponding Changelist Description pages.

For files whose filetype is "text," these menu choices are available:
View - head rev text Displays text of the most recent version of the file in the depot.
View - workspace file text Displays the text of the file in your workspace.
View - annotated file text Displays each line of a file's head revision with the line number where it was introduced.
Open head rev in browser Opens the most recent depot revision of the file in your browser.
Workspace diffs Displays the changes you've made to the file in your workspace.
Diff - workspace file vs. synced rev Displays the diffs between the file in your workspace and the version you're synced to.
Diff - synced rev vs. head rev Displays the diffs between the version you're synced to and the most recent version in the depot.
Diff - workspace file vs. head rev Displays the diffs between the file in your workspace and the most recent version in the depot.

You can run the following commands on any type of file:
Sync file... Sync to any revision of this file.
Open workspace file in editor Brings up the workspace file in an editor window
Submit default changelist... Submit just this file if it's open, or all the files in your default changelist.
Open for edit... Open this file for edit, optionally changing its type and putting it in a particular changelist.
Open for add... Open this file for add, optionally specifying its type and putting it in a particular changelist. (Available only if the file is not already opened for add or present in the depot.)
Open for delete... Open this file for delete, optionally putting it in a particular changelist.
Remove from workspace Removes the file from your workspace unless the file is currently open.
Integrate... Open this file so changes from another file can be integrated to it.
Resolve file... Merge changes into the current file using a variety of options.
Lock Locks file if it's opened by you and not locked by someone else.
Unlock Unlock file if it's locked by you.
Revert if unchanged The file is closed and taken off your pending changelist if you opened the file for edit but didn't change it, or if you opened the file for integrate but didn't resolve it.
Revert even though changed Regardless of what you've done to your workspace file, close it, replace it with a new copy from the depot, and take it off your pending changelist. Warning: this option overwrites any changes you made to your workspace copy of the file.

These shortcut buttons are available in the File view. With the exception of Open for add... and Open workspace file in editor, the commands in the File view work only with Perforce-managed files.
Show the Tree view.
Sync the file to the head revision.
Open for edit in default changelist, with no filetype change.
Open for delete in default changelist.
Show all diffs (the differences between your workspace file and the head revision of the file in the depot).
Open workspace file in an editor.
Show text of the head revision of the depot file.
Display the head revision in a web browser
Show file history
Go to the Submit Default Changelist page.
Revert the file if it is unchanged (see above)
Cancels your last server request before it is finished.


Copyright 2012 Perforce Software. All rights reserved.