Working with files

You can access the following Surround SCM commands from Visual C++: check out, check in, and undo check out. You can also view history or differences and view file properties.

Check out

Check out files when you need to make changes. You can check out single files, multiple files, or all files in a project. Surround SCM creates a read-write copy of the file in the working directory. See Checking out files for more information.

  1. Select the files or project. Choose Project > Source Control > Check Out.
  2. The Check out file(s) dialog box opens.

  3. Click Advanced to select advanced check out options.
  4. The Advanced Check Out Options dialog box opens.

  5. Select any options and click OK.
  6. You return to the Check out file(s) dialog box.

  7. Click OK.
  8. The files are checked out and ready for editing.

Undo check out

If you have a file checked out and need to revert changes, you can undo the check out command. See Undoing check out for more information.

  1. Select the files or project. Choose Project > Source Control > Undo Check Out.
  2. The Undo Check Out dialog box opens.

  3. Click Advanced to select advanced undo check out options.
  4. The Advanced Undo Check Out Options dialog box opens.

  5. Select a file overwrite option and click OK.
  6. You return to the Undo Check Out dialog box.

  7. Click OK.
  8. Make sure you selected the appropriate file overwrite option. Depending on the option you choose, any changes you made to the file are lost when you undo the checkout. This action cannot be undone.

Check in

Check in files after you finish making changes. Check in updates Surround SCM with changes, removes the lock on the files, and makes the changes available to other users. The version number is also incremented by one. See Checking in files for more information.

  1. Select the files or project. Choose Project > Source Control > Check In.
  2. The Check in file(s) dialog box opens.

  3. Click Advanced to select advanced check in options.
  4. The Advanced Check In Options dialog box opens.

  5. Select any options and click OK.
  6. You return to the Check in file(s) dialog box.

  7. Click OK.
  8. Surround SCM automatically merges changes when files are checked in. This ensures that changes are not accidentally lost or overwritten.

Show history

The history dialog box provides a convenient way to view a source file’s history and work with a historic version of the file. You can view file details, get or check out a file, create a label, select two version of a file to see differences, and view or edit the file. You can also filter the history to display specific files. See Viewing file history for more information.

  1. Select the file. Choose Project > Source Control > Show History.
  2. The History dialog box opens. This dialog box includes a summary of historic version information.

  3. Optionally select a user from the Filter by user menu.
  4. Optionally select an action from the Filter by action menu.
  5. Select an entry and click Details to view the file version details.
  6. Click Get to get the selected version of the file.
  7. Click Check Out to check out the selected version of the file.
  8. Click Create Label to label the selected version of the file.
  9. Click Differences to compare two selected versions of the file.
  10. Click View File to view the selected version of the file.
  11. Click Edit File to edit the selected version of the file.
  12. Click Rollback File to revert to a previous file version.
  13. Click Close to close the file history.

Show differences

Provides a visual display of the differences in a file. See Diffing files for more information.

  1. Select the file. Choose Project > Source Control > Show Differences.
  2. If there are differences, the diff utility opens.

File properties

You can view general and check out information about the selected file.

  1. Select the file. Choose Project > Source Control > Surround SCM Properties.
  2. The Properties dialog box opens with the General tab selected. This tab includes read-only information about the file. The Check Out tab includes read-only file check out information.

Refresh status

Refreshes the status of all files included in the project. Use this command if you change the status of one or more opened files using external tools.

Surround SCM

Launches the Surround SCM application.