Reverting Files

The revert command closes opened files by taking them out of your pending changelist instead of submitting them. It also affects your workspace as follows:

• When you revert a file opened for edit or integrate, your workspace copy of the file is replaced with a copy of the file from the depot. Changes you made to your workspace copy of the file will be lost when you run revert!

• When you revert a file opened for add, nothing happens to the file in your workspace; it is simply removed from your pending changelist.

• When you revert a file opened for delete, the deleted file is restored to your workspace from the depot.

• When you revert a file opened for branch/add, your workspace copy of the branched file is removed.

You can revert files by:

• Selecting Revert... from the pulldown menu at the top of the Files tab. This takes you to the Revert page, described in more detail below.

• Clicking the "Revert unchanged files" shortcut button with a directory selected. This immediately reverts any files opened for edit or integrate under that directory as long as you have not yet modified or resolved them.

  "Revert unchanged files" shortcut button

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

The Revert Page

Revert... takes you to the Revert page. Select the options you want and click the command button to either preview the revert or revert the files.

Command:

Preview Revert - Click on this button to see a preview of the revert without actually reverting the files.

Revert - Click this button to actually revert the files.

Options:

Restrict to unchanged files - this option causes revert to operate on only the files you have not yet modified in your workspace. (Note that files opened for add, delete, or branch/add, and files that have been resolved, are considered "modified.")

Restrict to changelist (changelist number) - this option causes revert to operate only on the files in the changelist that you select in the drop-down box.

Restricting files

If you came to the Revert Options page with a directory selected, you can select the files to revert.