revert.html #1

<TITLE>Reverting Files</TITLE>

<P> The <B>revert</B> command closes opened files by taking them out of your <a href="pendingchangelists?help">pending 
  changelist</a> instead of submitting them. Reverting also affects your workspace 
  as follows: 
<ul>
<p>
  <li> When you revert a file<b> opened for edit or integrate</b>, your workspace 
    copy of the file is replaced with a copy of the file from the depot. <font color=red> 
    Changes you made to your workspace copy of the file are lost when you revert! 
    </font> </li>
   
  <li> When you revert a file<b> opened for add</b>, nothing happens to the file 
    in your workspace. The file is simply removed from your pending changelist. 
  </li>  
  <li> When you revert a file<b> opened for delete</b>, the deleted file is restored 
    to your workspace from the depot.</li>

 
  <li> When you revert a file<b> opened for branch or add,</b> your workspace 
    copy of the branched file is removed. </li>
</ul>

<p>
You can revert files by:

<ul>
  <li>Selecting <b>Revert...</b> from the <b>Action</b> menu at the top of the 
    <B>Files</B> tab. This option displays the <b>Revert</b> page, described below. 
    <p> 
  <li>Clicking the "Revert unchanged files" shortcut button <img src="/runrevert?icon" border=none>with 
    a directory selected. This option immediately reverts any files opened for 
    edit or integrate under that directory as long as you have not yet modified 
    or <a href="resolve?help">resolved</a> them.</li><p> 
    
  <li>Clicking the "Revert unchanged files" shortcut button with a file selected. 
    This immediately reverts the current file if it was opened for edit or integrate 
    as long as you have not yet modified or resolved it. 
</ul>

<p>
<h3>The Revert Page</h3>

<p> <b>Revert...</b> takes you to the <b>Revert</b> page. Select the options you 
  want and click the command button to preview the revert or revert the files. 
<p><b>Options: </b>
<ul>
  <li> <B>Restrict to unchanged files:</B> Revert only the files you have not 
    yet modified in your workspace. (Files opened for add, delete, or branch/add, 
    and files that have been resolved, are considered "modified.")</li>
  <li><B>Restrict to changelist <I>(changelist number)</I></B>: Revert the files 
    in the selected changelist. </li>
</ul>