Shelving Changes

You can shelve changes to a personal stream using the desktop client and the Windows Explorer, Eclipse, and Visual Studio integrations.

To shelve changes:

  1. In the desktop client open the stream that you want to shelve and do one of the following:

  2. In Windows Explorer right-click the root folder of the stream, or any subfolder, and select Dimensions | Shelve.

    The Shelve wizard opens.

    TIP  You can shelve the changes from the work areas of regular and personal streams.

  3. Enter a name for the personal stream, the default is:

  4. <Username>_<ID of the parent stream>

  5. Enter a unique branch name, the default is:

  6. <Username>_<ID of the parent stream>

  7. Optionally modify the default description of the personal stream.

  8. After the shelving operation is complete, by default the Update operation is invoked to reset the work area to the latest repository content and the local changes are discarded. If you do not want to reset the work area unselect Reset work area changes after shelving (or ignore the Reset step when shelving is complete).

  9. Optionally add the new personal stream to your list of favorite streams.

  10. Click Next. The next few pages of the Shelve wizard are similar to delivering changes, for details see Delivering Changes from a Work Area to a Stream.

  11. TIP  To speed up the shelve operation limit the scope to the folders that contain your changes instead of shelving the entire stream.

  12. When you have competed the wizard click Shelve.

  13. If you have opted to reset the work area click Reset. The Update wizard opens. The stream to be used for the update is the same one that is associated with the work area. In the Advanced section the following options are selected by default:

Complete the Update wizard, for details see Updating a Work Area from a Stream and Resolving Conflicts.