CLion 2016.3 Help

Shelf Tab

View | Tool Windows | Version Control - Shelf

The tab is added to the Version Control tool window when you shelve a change or a changelist, and is displayed until you permanently remove all shelved changes, including the already unshelved ones, and imported external patches.

By default, this tab shows all shelved changes that have not been unshelved yet. Changes are grouped into shelves. A shelf is a changelist created when you shelve changes. A shelf is identified by the commit message. You can have CLion show the unshelved changes. They can be restored and re-applied as many times as necessary, until they are removed permanently.

For details, see Shelving and Unshelving Changes.

Toolbar

ItemTooltip and shortcutDescription
/help/img/idea/2016.3/icon_showDiff.png
Show Diff Ctrl+DChoose this option to open the Differences Viewer and compare the shelved version of a file with its current local version.
/help/img/idea/2016.3/iconCreatePatch.png
Create PatchChoose this option to create a patch file based on a shelved change. In the Create Patch dialog box that opens, specify the file to save the patch in, and the changes to create a patch from. By default, all changes from the selected shelf are involved in the patch creation. To view which changes are included, click the Selected link.

For details, see Creating Patches.

/help/img/idea/2016.3/show_already_unsheved.pngShow/Hide already unshelvedClick this button to have CLion show or hide all available shelved changes, both already applied and not. Note that this button is duplicated on the context menu.
/help/img/idea/2016.3/cogwheel_blue.pngClick this button the reveal the menu of actions described below.

Context menu

The context menu and the toolbar button /help/img/idea/2016.3/cogwheel_blue.png provide the same set of actions. The context menu is available by right-clicking a change, a change list, or anywhere in the tab.

ItemShortcutDescription
Unshelve ChangesChoose this option to apply all changes from the selected shelf. In the Unshelve Changes to Changelist dialog box box that opens, specify the changelist you want to add the changes to. For details, see Unshelving Changes.
UnshelveCtrl+Shift+UChoose this option to select specific changes you want to unshelve instead of applying an entire shelf. In the Unshelve Changes to Changelist dialog box box that opens, specify the changes you want to apply, and the changelist you want to add these changes to. For details, see Unshelving Changes.
RestoreChoose this option to re-activate the unshelved changes. By default, unshelved changes are no longer shown in the list of available shelved changes, therefore you first need to have CLion display it by choosing Show Already Unshelved. You can restore any change as many times as you need until the change is permanently removed by choosing Delete. For details, see Filtering Out and Removing Unshelved Changes and Restoring Unshelved Changes.
Import PatchesChoose this option to apply patches created externally or through CLion. In the dialog box that opens, choose the files to import patches from. The imported patches are treated as shelved changes and are shown in the Shelf tab of the Version Control tool window where you can unshelve them at any time.
RenameShift+F6Choose this option to modify the name of the selected shelved changelist.
DeleteDeleteChoose this option to permanently delete the selected shelved change. Tiy can remove any change no matter whether it has been already unshelved or not. For details, see Filtering Out and Removing Unshelved Changes.
Show Already UnshelvedChoose this option to have CLion show all available shelved changes, both already applied and not. By default, unshelved changes are hidden. For details, see Filtering Out and Removing Unshelved Changes.
Delete All Already UnshelvedChoose this option to have CLion permanently remove all shelved changes that have been already applied. For details, see Filtering Out and Removing Unshelved Changes.

See Also

Last modified: 29 March 2017