<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 contains 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. |
||
| //guest/perforce_software/p4web/Help/filebrowser.html | |||||
| #1 | 8914 | Matt Attaway | Initial add of the P4Web source code | ||