Edit files

To edit a file:

1. In the Tree pane, find the file that you want to edit.

   For details, see Retrieving Files from the Depot.

2. Right-click the file and choose Check Out or Check Out and Open.

   When you check out a file, it is placed in a changelist.

3. (Optional) To prevent others from submitting changes to that file, right-click the file and choose Lock.

   Note

   When a user is connected to an edge server and locks a file, the lock is global, meaning it is promoted to the commit server. Therefore the locked status is visible to users connected to other edge servers or to the commit server:

   A file remains locked until the file is submitted, reverted, or unlocked.

4. To launch the associated editor, double-click the file or right-click and choose Open With. (You might need to associate an editor with the file type.

   To define an editor: choose Tools > Preferences, click the Editor tab, and specify the desired editor for the file type.)

5. Using the editor associated with the file type, make your changes.

6. To place your revised version in the depot so other users can have access to it, right-click the file and choose Submit​.

   In the Pending Changelist dialog, enter a description of your changes and submit the changelist that contains the file.

To display a file without opening it for edit, double-click the file icon.