- <HTML><HEAD><TITLE>P4Web User Guide - Using the File view</TITLE></HEAD><BODY>
- <P>
- The <b>File view</b> 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 <i>name</i> portion of any of
- the files listed in the <a href="pathbrowser?help">Tree view</a>.
- You can also get to the File view
- by clicking any of the file links list in the
- <a href="describe?help">Changelist Description</a> page,
- the
- <a href="submit?help">Submit Changelist</a> page, or the
- <a href="editpending?help">Pending Changelist</a> page.
- (If you are using P4Web in
- <a href="browseonly?help">Viewer mode</a>,
- some of the information,
- links and menu items described here won't be visible to you.)
- <p>
- 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 <a href="pathbrowser?help">Tree view</A>.
- <p> Detailed state information follows the current file heading:
- <table width="66%" border="1" cellpadding="1">
- <tr>
- <td width="18%"><b>Type</b>, <b>Have</b>, and <b>Head</b> </td>
- <td width="82%"> The file's <a href="help_filetypes?help">filetype</a>, the
- revision you have in your client workspace, and the head revision in the
- depot, respectively. </td>
- </tr>
- <tr>
- <td width="18%"><b>Workspace</b></td>
- <td width="82%">
- <p>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.
- <p> Additional state information is displayed if your workspace file needs to
- be <a href="sync?help">synced</a>, if you and/or anyone else has the file
- opened, if you need to <a href="resolve?help">resolve</a> the file, and
- so forth. </p>
- </td>
- </tr>
- <tr>
- <td width="18%"><b>File state</b></td>
- <td width="82%">Displays Perforce state information for the current file.</td>
- </tr>
- <tr>
- <td width="18%"><a href="filelog?help"><b>Revision History</b></a></td>
- <td width="82%">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.) </td>
- </tr>
- <tr>
- <td width="18%"><b>Changelist description/action</b></td>
- <td width="82%"> Displays a summary list of all changelists submitted to this
- file, with links to the corresponding <a href="describe?help">Changelist
- Description</a> pages. </td>
- </tr>
- </table>
- <p>
- For files whose <a href="filetype?help">filetype</a> is "text," these menu choices
- are available:
- <table width="66%" border="1" cellpadding="1">
- <tr>
- <td><b>View - head rev text</b> </td>
- <td>Displays text of the most recent version of the file in the depot. </td>
- </tr>
- <tr>
- <td><b>View - workspace file text</b></td>
- <td>Displays the text of the file in your workspace. </td>
- </tr>
- <tr>
- <td><b>View - annotated file text</b></td>
- <td>Displays each line of a file's head revision with the line number where it
- was introduced. </td>
- </tr>
- <tr>
- <td><b>Open head rev in browser</b></td>
- <td>Opens the most recent depot revision of the file in your browser. </td>
- </tr>
- <tr>
- <td><b>Workspace diffs</b></td>
- <td>Displays the changes you've made to the file in your workspace. </td>
- </tr>
- <tr>
- <td><b>Diff - workspace file vs. synced rev</b></td>
- <td>Displays the diffs between the file in your workspace and the version
- you're synced to. </td>
- </tr>
- <tr>
- <td><b>Diff - synced rev vs. head rev</b></td>
- <td>Displays the diffs between the version you're synced to and the most recent
- version in the depot. </td>
- </tr>
- <tr>
- <td><b>Diff - workspace file vs. head rev</b></td>
- <td>Displays the diffs between the file in your workspace and the most recent
- version in the depot. </td>
- </tr>
- </table>
- <p> You can run the following commands on any type of file:
- <table width="66%" border="1" cellpadding="1">
- <tr>
- <td width="17%"><a href="sync?help">Sync file...</a></td>
- <td width="83%">Sync to any revision of this file. </td>
- </tr>
- <tr>
- <td width="17%"><a href="launcheditor?help">Open workspace file in editor</a></td>
- <td width="83%">Brings up the workspace file in an editor window</td>
- </tr>
- <tr>
- <td width="17%"><a href="submit?help">Submit default changelist...</a> </td>
- <td width="83%">Submit just this file if it's open, or all the files in your
- default changelist. </td>
- </tr>
- <tr>
- <td width="17%"><a href="edit?help">Open for edit...</a></td>
- <td width="83%">Open this file for edit, optionally changing its type and
- putting it in a particular changelist. </td>
- </tr>
- <tr>
- <td width="17%"><a href="add?help">Open for add...</a> </td>
- <td width="83%">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.) </td>
- </tr>
- <tr>
- <td width="17%"><a href="delete?help">Open for delete...</a></td>
- <td width="83%">Open this file for delete, optionally putting it in a particular
- changelist. </td>
- </tr>
- <tr>
- <td width="17%"><a href="remove?help">Remove from workspace</a></td>
- <td width="83%">Removes the file from your workspace unless the file is currently
- open. </td>
- </tr>
- <tr>
- <td width="17%"><a href="integrate?help">Integrate...</a> </td>
- <td width="83%">Open this file so changes from another file can be integrated
- to it. </td>
- </tr>
- <tr>
- <td width="17%"><a href="resolve?help">Resolve file...</a></td>
- <td width="83%">Merge changes into the current file using a variety of options.
- </td>
- </tr>
- <tr>
- <td width="17%"><a href="lock?help">Lock</a> </td>
- <td width="83%">Locks file if it's opened by you and not locked by someone
- else. </td>
- </tr>
- <tr>
- <td width="17%"><a href="unlock?help">Unlock</a></td>
- <td width="83%">Unlock file if it's locked by you. </td>
- </tr>
- <tr>
- <td width="17%"><a href="revert?help">Revert if unchanged</a></td>
- <td width="83%">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.</td>
- </tr>
- <tr>
- <td width="17%"><a href="revert?help">Revert even though changed</a></td>
- <td width="83%">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. <font color=red>Warning: this option overwrites any changes
- you made to your workspace copy of the file.</font> </td>
- </tr>
- </table>
- <p>These shortcut buttons are available in the <b>File</b> view. With the exception
- of <b>Open for add...</b> and <b>Open workspace file in editor</b>, the commands
- in the <b>File</b> view work only with Perforce-managed files.
- <table width="33%" border="1" cellpadding="1">
- <tr>
- <td><img src="/gotree?icon"></td>
- <td>Show the <a href="pathbrowser?help">Tree view</a>. </td>
- </tr>
- <tr>
- <td><img src="/runsync?icon"></td>
- <td><a href="sync?help">Sync</a> the file to the head revision. </td>
- </tr>
- <tr>
- <td><img src="/runedit?icon"></td>
- <td><a href="edit?help">Open for edit</a> in default changelist, with no filetype
- change. </td>
- </tr>
- <tr>
- <td><img src="/rundelete?icon"></td>
- <td><a href="delete?help">Open for delete</a> in default changelist. </td>
- </tr>
- <tr>
- <td><img src="/rundiff?icon"></td>
- <td>Show all diffs (the differences between your workspace file and the head
- revision of the file in the depot). </td>
- </tr>
- <tr>
- <td><img src="/launchedit?icon"></td>
- <td>
- Open workspace file in an <a href="launcheditor?help">editor</a>.
- </td>
- </tr>
- <tr>
- <td><img src="/showtext?icon"></td>
- <td>Show text of the head revision of the depot file. </td>
- </tr>
- <tr>
- <td><img src="/browsetext?icon" width="25" height="25"></td>
- <td>Display the head revision in a web browser </td>
- </tr>
- <tr>
- <td><img src="/showfilelog?icon"></td>
- <td>Show <a href="filelog?help">file history</a> </td>
- </tr>
- <tr>
- <td><img src="/runsubmit?icon"></td>
- <td>Go to the <a href="submit?help">Submit Default Changelist</a> page. </td>
- </tr>
- <tr>
- <td><img src="/runrevert?icon"></td>
- <td><a href="revert?help">Revert</a> the file if it is unchanged (see above)
- </td>
- </tr>
- <tr>
- <td><img src="/cancel?icon"></td>
- <td>Cancels your last server request before it is finished. </td>
- </tr>
- </table>
- </BODY></HTML>
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#1 | 12234 | Matt Attaway | Rejigger P4Web project in preparation for official sunsetting The bin directory contain...s the last official builds of P4Web from the Perforce download site. P4Web is soon to be completely sunsetted; these builds are here for folks who don't want to build their own. To better handle the archived builds the source code has been moved into a separate src directory. « |
10 years ago | |
//guest/perforce_software/p4web/Help/filebrowser.html | |||||
#1 | 8914 | Matt Attaway | Initial add of the P4Web source code | 11 years ago |