P4Web User Guide - Using the File view

Using the File view

The File view allows you to view detailed information about a file, and to work on that file. You get to the File view by clicking on the file name portion of any of the files listed in the Tree view. You can also get to the File view by clicking on any of the file links list in the Changelist Description page, the Submit Changelist page, or the Pending Changelist page. (Note that 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 show the file's filetype, the revision you have in your client workspace, and the head revision in the depot, respectively.
• Workspace shows exactly where the file is located in your workspace and gives you a browser link to it. If you click on this link, your browser will open the workspace file, allowing you to view work in progress. Note the following exceptions:
  • The file must be local to the machine running the browser.
  • Some browsers do not support this functionality.
• Additional state information is shown 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 shows Perforce state information for the current file.
• Revision History shows the complete history of the file and provides links to previous file version information and content. (This is the default File view display.)
• Changelist description/action gives a summary list of all changelists submitted to this file, with links to the corresponding Changelist Description pages.

• View - head rev text shows text of the most recent version of the file in the depot.
• View - workspace file text shows the text of the file in your workspace.
• View - annotated file text shows each line of a file's head revision with the line number where it was introduced.
• View - fully annotated file text also shows deleted lines and the range of revisions for each line.
• Open head rev in browser opens the most recent depot revision of the file in your browser.
• Workspace diffs shows the changes you've made to the file in your workspace.
• Diff - workspace file vs. synced rev shows the diffs between the file in your workspace and the version you're synced to.
• Diff - synced rev vs. head rev shows the diffs between the version you're synced to and the most recent version in the depot.
• Diff - workspace file vs. head rev shows 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. The menu choices labelled with "..." will prompt you for more information; the other choices run the command immediately:

• 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 it's 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 file if it's opened by you and not locked by someone else.
• Unlock file if it's locked by you.
• Revert if unchanged -- 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, the file will be closed and taken off your pending changelist.
• 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 will overwrite any changes you made to your workspace copy of the file.

These shortcut buttons are available on the File view:

• 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.

With the exception of Open for add... and Open workspace file in editor, the commands in the File view work with Perforce-managed files only.