Shelving files

Shelve files to store them in Surround SCM without adding or checking them in. You can only shelve files that are modified from the current version or missing from Surround SCM.

Use the Shelves window to shelve files that are not under source control. See Adding files to existing shelves.

1. Select the files or repositories to shelve and choose Activities > Shelve Files.

The Shelve Files dialog box opens.

2. Select a Shelf to store the files in. The list includes shelves you own and shelves shared with you by other users.

Select <New shelf> to create a shelf. See Creating shelves.

3. Expand the Local file options to select options for handling local files.

  • Get original version replaces the local file with the original version and reverts the check out if files are checked out.
  • Get latest version replaces the local file with the latest version and reverts the check out if files are checked out.
  • Leave local file leaves the local file as is.
  • Make files writable leaves a read-write copy of the file in the working directory.

4. Select View Shelves window after shelving files to open the Shelves window after files are shelved.

5. Select Recursive to shelve all new and modified files in the selected repository and all subrepositories. This option is available only if you are shelving from a repository.

6. Click OK.

The files are shelved.

After a file is shelved, only other files from the same branch can be added to the shelf. However, you can unshelve files across branches. For example, you may add new files to a shared shelf from the working directory for a workspace branch. Other users can unshelve those files to the working directory associated with their workspace branch or a baseline branch on the same mainline branch. See Unshelving files.