Shelving enables you to store local changes in a personal stream in a repository and optionally remove the changes from a work area. You can use shelving to:
Shelve changes and reset a work area
Remove changes from a work area that you do not want to deliver to the associated stream when:
The changes are not stable or complete.
You need to interrupt your current work and set aside the changes.
You need to switch to a different task but want to use the same work area rather than populate a new one, which can be time consuming.
After the shelving operation is complete you can reset the work area to the latest repository content.
Backup changes
When you are sharing a stream with other developers, but are not ready to deliver your local changes, you can backup your work by committing it to a personal stream. This creates a snapshot of the work area at that point in time. You can later revert your work area to this snapshot by merging from the shelved personal stream. When creating backups you keep the local changes and do not need to reset the work area.
|
Field |
Description |
|
Personal stream name |
Enter a name for the personal stream to be created, the default is: <Username>_<ID of the parent stream> |
|
Unique branch name |
Enter a unique branch name for the personal stream, the default is: <Username>_<ID of the parent stream> |
|
Description |
Optionally modify the default description of the personal stream. |
|
After shelving reset the work area to the latest repository content |
After the shelving operation is complete, by default the work area is reset to the latest repository content and the local changes are discarded. If you do not want to reset the work area unselect this option. |
|
Add the new stream my favorites |
Optionally add the new personal stream to your list of favorite streams. |