pathbrowser.html #1

<TITLE>Using The Tree view</TITLE>

<P> The <B>Tree view</B> 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. (If you are using P4Web in <a href="browseonly?help">Viewer mode</a> 
  instead of <a href="helper?help">Standard mode</a>, only a subset of commands 
  are available to you.) 
<p>
<table border=0 align=right cellpadding=5 cellspacing=5 bgcolor=#eeeeee>
<tr><th><img src="/recentactivity?icon" alt="Show/Hide Recent Activity" border=1><br>
<font size=-3>"Show/Hide Recent Activity"</font>
</th></tr>
</table>
The <a href="controlpanel?help">control panel</a> offers <a href="pathbrowser?help#menus">menus</a> 
and <a href="pathbrowser?help#shortcuts">shortcut buttons</a>, described below. 
Click <b>Show Recent Activity</b> to display the most recent <a href="defs?help#changelist">changelists</a> 
affecting the files in the current path. 
<p> 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 those links to navigate down the path hierarchy. 
<p>
You can browse either
<a href="defs?help#depot">depot</a> or
<a href="defs?help#workspace">workspace</a> paths in the Tree view.
See
<a href="browsemodes?help">Depot Browsing vs. Workspace Browsing</a> to find
out what the difference is, why each is useful, and how to switch between them.

<p> Though the Tree view can 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 <a href="filebrowser?help">File view</a>. 
<p>
Files shown in the Tree view have
<a href="pathbrowser?help#icons">state icons</a> showing
their current state in the depot and in your workspace;
see below for a key to their meanings.

<a name=menus>
<h4>File operation menu</h4>
</a> 
<P> The <b>Action</b> menu at the top of the page allows you to work on files 
  in the current path. To specify whether commands are run on all or selected 
  files in the current path, select the directory or a file before running the 
  command. 
<table width="66%" border="1" cellpadding="1">
  <tr>
    <td><a href="sync?help">Sync...</a></td>
    <td>Synchronizes your workspace files with newer (or older) depot files. </td>
  </tr>
  <tr>
    <td><a href="remove?help">Remove from workspace</a> </td>
    <td>Removes files from your workspace without affecting depot files.</td>
  </tr>
  <tr>
    <td><a href="edit?help">Open for edit...</a></td>
    <td>Makes your workspace files writable so you can work on them. </td>
  </tr>
  <tr>
    <td><a href="add?help">Open for add...</a> </td>
    <td>Adds new files to the depot. </td>
  </tr>
  <tr>
    <td><a href="delete?help">Open for delete...</a></td>
    <td>Deletes depot files and removes them from your workspace. </td>
  </tr>
  <tr>
    <td><a href="revert?help">Revert...</a></td>
    <td>Discards changes to opened files and close files without submitting them 
      to the depot. </td>
  </tr>
  <tr>
    <td><a href="filetype?help">Change filetype...</a></td>
    <td>Opens files so they can be submitted to the depot with a different filetype. 
    </td>
  </tr>
  <tr>
    <td><a href="integrate?help">Integrate...</a></td>
    <td>Branch files or propogate changes between branched files.</td>
  </tr>
  <tr>
    <td><a href="resolve?help">Resolve...</a> </td>
    <td>Reconcile your changes with changes made by other users.</td>
  </tr>
  <tr>
    <td><a href="lock?help">Lock...</a></td>
    <td>Prevent other people from updating depot files you have opened.</td>
  </tr>
  <tr>
    <td><a href="unlock?help">Unlock...</a> </td>
    <td>Releases locks on your opened files. </td>
  </tr>
</table>
<p> If you are in <a href="browsemodes?help">workspace browsing</a> mode, the 
  tree displays all the files in your workspace, including those not managed by 
  Perforce. (You'll recognize the Perforce-managed files by their <a href="pathbrowser?help#icons">icons</a>.) 
  With the exception of<b> Open for add...</b>, the commands in the <b>Action</b> 
  menu operate only on Perforce-managed files.
<p>
<h4>File filter</h4>
      The file filter allows you to display various information about files at 
or below the current path level. After making filter selections, click <B>Filter</B> 
to display the results. 
<ul>
      <p>
<li>You can select the following options from the first filter pull-down menu:
      <UL>
      <LI><B>No Filter</B>: lists files present at the current path level, plus 
        any files you have <a href="defs?help#openedfiles">open</a> in subdirectories 
        of the current path. 
      <LI><B>Hide files in subfolders</B>: lists only directories, not the files 
        in them. 
      <LI><B>Opened files - all clients</B> : lists 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.) 
      <LI><B>Opened unchanged files</B>: lists files you have opened but have 
        not changed. 
      <LI><B>Changed unopened files</b>: lists files you have changed without 
        having opened them first with Perforce. 
      <LI><B>Submitted Changelists</B>: lists all submitted changelists affecting 
        files in the current path, with links to more info about them. 
      <LI><B>Files missing from workspace</B> - shows files that were synced in your workspace but are missing now. (That is, they were removed by something outside of Perforce's control.)
      <LI><B>Unsynced files</B>: lists your workspace files that are not <a href="sync?help">synced</a> 
        to head revisions. 
      <LI><B>Unresolved files</B>: lists the files that need <a href="resolve?help">resolving</a>, 
        either because you have them opened for integrate, or because you re-synced 
        files after opening them for edit. 
    </UL>
      <p>
  <LI>The <B>Files matching...</B> option lets you <a href="findfiles?help">find 
    files</a> whose names match a pattern you specify. Click <b>Include subfolders</b> 
    to search directories below the current path. 
    <p>
</ul>
If you in <a href="browsemodes?help">depot browsing</a> mode, you have two additional filter options:
<ul>
  <li><b>Show deleted files</b>: displays files that have been deleted in the 
    depot. 
  <li><b>Show only files in client view</b>: list only files in your <a href="editclient?help"> 
    client view</a>. 
</ul>
<a name=shortcuts><h4>Shortcut Buttons</h4> 
</a> The Path Browser's shortcut buttons give you quick links to these common 
operations: 
<table width="33%" border="1" cellpadding="1">
  <tr>
    <td><img src="/gotree?icon" border=1></td>
    <td>Displays the Tree view</td>
  </tr>
  <tr>
    <td><img src="/runsync?icon" border=1></td>
    <td><a href="defs?help#sync">Sync</a> files in this path to head revisions. 
      Copies updated files from the <a href="defs?help#depot">depot</a> into your 
      workspace. </td>
  </tr>
  <tr>
    <td><img src="/runsubmit?icon" border=1></td>
    <td>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. </td>
  </tr>
  <tr>
    <td><img src="/runrevert?icon" border=1></td>
    <td>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.)</td>
  </tr>
  <tr>
    <td><img src="/recentactivity?icon" border=1></td>
    <td>Toggle display of recent activity in the control panel. </td>
  </tr>
  <tr>
    <td><img src="/cancel?icon" border=1></td>
    <td>Cancels your last server request. </td>
  </tr>
</table>

   

<a name=icons>
<h4>File state icons</h4>
</a> 
<table width="66%" border="1" cellpadding="1">
  <tr> 
    <td rowspan="2"><b>Files that are up-to-date</b></td>
    <td><img src="/synced?icon"
           alt="at head revision"></td>
    <td>The file in your workspace file is in sync with the head revision of the 
      depot file. </td>
  </tr>
  <tr> 
    <td><img src="/syncednone?icon"
           alt="not in workspace"></td>
    <td>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.) </td>
  </tr>
  <tr> 
    <td rowspan="6"><b>Files open in your current client workspace</b></td>
    <td><img src="/edit?icon"
           alt="opened for edit"></td>
    <td>The file is open for edit in your workspace. </td>
  </tr>
  <tr> 
    <td><img src="/add?icon"
           alt="opened for add"></td>
    <td>The file is open for add in your workspace. </td>
  </tr>
  <tr> 
    <td><img src="/delete?icon"
           alt="opened for delete"></td>
    <td>The file is open for delete in your workspace. </td>
  </tr>
  <tr> 
    <td><img src="/integ?icon"
           alt="opened for integ"></td>
    <td> The file is open for integrate in your workspace. </td>
  </tr>
  <tr> 
    <td><img src="/branch?icon"
           alt="opened for integ"></td>
    <td>The file is open for branch in your workspace. </td>
  </tr>
  <tr> 
    <td><img src="/locked?icon"
           alt="locked"></td>
    <td>The file is locked in your workspace. </td>
  </tr>
  <tr> 
    <td rowspan="2"><b>Files that you won't be able to submit until you've performed 
      some action on them</b></td>
    <td><img src="/sync?icon"
           alt="needs sync"></td>
    <td>The file needs to be re-synced before you can submit it. </td>
  </tr>
  <tr> 
    <td><img src="/resolve?icon"
           alt="needs resolve"></td>
    <td>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. </td>
  </tr>
  <tr> 
    <td rowspan="5"><b>Information that is independent of the state of your workspace</b></td>
    <td><img src="/theiropen?icon"
           alt="opened by other clients"></td>
    <td>The file is also open in another client workspace. </td>
  </tr>
  <tr> 
    <td><img src="/theirlock?icon"
           alt="locked by another client"></td>
    <td>The file has been locked in another client workspace. </td>
  </tr>
  <tr> 
    <td><img src="/headdeleted?icon"
           alt="head revision deleted"></td>
    <td>The head revision of the file has been deleted. </td>
  </tr>
  <tr> 
    <td><img src="/subdir?icon"
           alt="in subdirectory"></td>
    <td>The file lives in a subdirectory below the current path. </td>
  </tr>
  <tr> 
    <td><img src="/unmapped?icon"
           alt="not in client view"></td>
    <td>The file is not mapped in your client view. (You must have "Show entire 
      depot view" set to see this state.) </td>
  </tr>
</table>
<P>


<a name=fstat>
<h4>File state details</h4>
</a>

<p> Each file shown in the tree view is followed by details in the following format: 
<blockquote><tt>#[<i>have</i>]/[<i>head</i>] [<i>filetype</i>]</tt></blockquote>

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
<a href="filetype?help">filetype</a> is "executable text".