MPS 2019.3 Help

Local Changes tab

The Local Changes tab of the Version Control tool window Alt+9 lists all files that have been added or modified locally and have not yet been committed to the repository.

Use this tab to commit and revert changes, manage changelists, view differences, and clean up locked folders.

Toolbar

Item

Tooltip and Shortcut

Description

the Refresh button

Refresh Ctrl+F5

Click this button to refresh the status of all files in your workspace, modified both through MPS or through any other application.

the Force refresh button

Force Refresh

This button is only available if you are using Perforce as your version control system.

Click this button to refresh the status of files in your workspace, both modified through MPS or through other applications.

the Commit button

Commit Changes

Click this button to check in the selected change or changelist.

the Revert icon

Revert
Ctrl+Alt+Z

Click this button to roll back the selected changes.

the Show diff icon

Show Diff
Ctrl+D

Click this button to view the differences between your local version of the selected file and its latest version in the repository.

the Changelists icon

Changelists

Click this icon to invoke a list of commands related to managing changelists:

  • New Changelist

  • Edit Changelist

  • Delete Changelist

  • Set Active Changelist

  • Move to Another Changelist

the Shelve Silently icon

Shelve Silently
Ctrl+Shift+H

Click this button to shelve the selected file or changelist silently, without displaying the Shelve Changes dialog.

the Group By icon

Group By
Ctrl+P

Click this icon to choose how you want to group files: by directory, module or repository (if there's more than one root).

the Eye icon

Ignored Files

Click this icon to invoke a list of commands related to ignored files:

  • Show Ignored Files: choose to display the Ignored Files node with a list of files ignored by your VCS.

  • Show Files Related to Active Changelist: choose to let MPS detect files that are normally committed together with the files in the active changelist, and display them under the Related Files node.

the Preview Diff icon

Preview Diff

Click this button to have MPS open or close the Preview Diff pane to compare the current file with the latest committed revision.

Changelists pane

This pane shows all your changelists, and the files that have been modified in each changelist.

If new files have been added to your project that have not yet been checked-in to a version control system, the Unversioned Files node appears under which all such files are listed. If you have a large number of unversioned files (over 50), they are not displayed in the changelists pane. Instead, the Click to browse link appears. Click this link to open the Unversioned Files dialog to review the list of unversioned files. You can quickly delete unversioned files from the Changelists pane or the Unversioned Files dialog by pressing Delete, or add them to the VCS by pressing Ctrl+Alt+A.

Context menu of a selection

Item

Shortcut

Description

the Commit icon Commit

Ctrl+Alt+K

Select this option to check in the selected file or changelist.

the Revert icon Revert

Ctrl+Alt+Z

Select this option to roll back the selected changes.

Move to Another Changelist

F6

Select this option to move the selected item to another changelist.

the Show diff icon Show Diff

Ctrl+D

Select this option to view the differences between your local copy and the latest version in the repository.

the Jump to Source icon Jump to Source

F4

Select this option to open the selected file(s) in the editor.

the Delete icon Delete

N/A

This option is only available if single files are selected, not a changelist.

Ignore

N/A

This option is only available if a file under the Unversioned Files node is selected. Use this option to ignore the selected file if you want to leave it unversioned.

the New Changelist icon New Changelist

Alt+Insert

This option is only available if a changelist is selected.

Select this option to create a new changelist.

the Delete Changelist icon Delete Changelist

N/A

This option is only available if a changelist is selected.

Select this option to delete the selected changelist.

the Set Active Changelist icon Set Active Changelist

Ctrl+Space

Click this button to make the selected changelist active. The active changelist is highlighted.

the Edit Changelist icon Edit Changelist

Check Out

N/A

This option is only available if a file under the Modified without Checkout node is selected. Use this option to check out the selected file from the repository.

Add to VCS

N/A

This option is only available if a file under the Unversioned Files node is selected. Use this option to add the selected files to your version control system.

the Create Patch icon Create Patch

N/A

Select this option to create a patch.

Copy as Patch to Clipboard

N/A

Select if you do not need to save a patch to a file and want, for example, to send it by email or through a messenger.

the Shelve Changes icon Shelve Changes

N/A

Select this option to shelve the selected changes.

Shelve in Perforce

N/A

This option is only available if you are using Perforce as a version control system.

Select this option to shelve your changes in Perforce. You will be asked to select which files you want to shelve and provide a description. After you've shelved your changes, the corresponding changelist will appear. You can unshelve it any time from the changelist's context menu.

the Show Local Changes as UML icon Show Local Changes as UML

N/A

Use this action to show classes from the selected changelist in a UML Class diagram.

the Refresh icon Refresh

Ctrl+F5

Select this option to refresh the status of files in your workspace.

Local History

N/A

Select this option and choose one of the following from the popup menu:

  • Show History: select this option to view Local History of the selected file or folder.

  • Put Label: select this option to add a label to the current version of the selected file or folder.

<Specific version control system>

N/A

Select this option to invoke a popup menu with options specific to the version control system you are using.

Deployment

N/A

The option is only available if the FTP/SFTP Connectivity plugin is enabled and at least one server access configuration is defined.

Select this option to invoke a popup menu with deployment-related actions:

  • Upload to: select this option or press N/A and then select a server or a server group to upload items to. If the default server or server group is appointed, an additional Upload to <default deployment server or server group> action is also available.

  • Compare with deployed to: select this option and then select a server to compare a single file with its remote version. If the default server or server group is appointed, an additional Compare with deployed to <default deployment server> action is also available.

  • Sync with deployed to: select this option and then select a server to synchronize local items with their remote versions.

See Uploading and Downloading Files and Comparing Deployed Files and Folders with Their Local Versions for details.

Preview Diff Pane

This pane opens when you click the Preview Diff button the Preview details icon on the toolbar. In this pane you can examine the changes made to the selected file compared to its base revision.

The pane consists of two areas:

  • The affected code as it was in the base revision.

  • The affected code as it is after a change has been made.

Item

Tooltip and Shortcut

Description

the Previous Difference button/the Next Difference button

Previous Difference / Next Difference Shift+F7 F7

Use these buttons to jump to the next/previous difference.

When the last/first difference is reached, MPS suggests to click the arrow buttons F7/Shift+F7 once more and compare other files, depending on the Go to the next file after reaching last change option in the Differences Viewer settings.

This behavior is supported only when the Differences Viewer is invoked from the Version Control tool window Alt+9 .

the Back button
the Forward button

Compare Previous/Next File
Alt+LeftAlt+Right

Click these buttons to compare the local copy of the previous/next file with its update from the server.

the Edit button

Jump to Source
F4

Click this button to open the selected file in the active pane in the editor. The caret will be placed in the same position as in the Differences Viewer.

Viewer type

Use this list to choose a viewer type. The side-by-side viewer has two panels; the unified viewer has one panel only.

Both types of viewers enable you to

  • Edit code. Note that one can change text only in the right-hand part of the default viewer, or, in case of the unified viewer, in the lower ("after") line, that is in your local version of the file.

  • Perform the Apply/Append/Revert actions.

Whitespace

Use this list to define how the differences viewer should treat whitespaces.

  • Do not ignore: white spaces are important, and all differences are highlighted. This option is selected by default.

  • Trim whitespaces: ("\t", " "), if they appear in the end and in the beginning of a line.

    • If two lines differ in trailing whitespaces only, these lines are considered equal.

    • If two lines are different, such trailing whitespaces are not highlighted in the By word mode.

  • Ignore whitespaces: white spaces are not important, regardless of their location in the source code.

  • Ignore whitespaces and empty lines: the following entities are ignored:

    • all whitespaces (as in the 'Ignore whitespaces' option)

    • all added or removed lines consisting of whitespaces only

    • all changes consisting of splitting or joining lines without changes to non-whitespace parts.
      For example, changing a b c to a \n b c is not highlighted in this mode.

Highlighting mode

Select the way differences granularity is highlighted.

The available options are:

  • Highlight words: the modified words are highlighted

  • Highlight lines: the modified lines are highlighted

  • Highlight split changes: if this option is selected, big changes are split into smaller 'atomic' changes.
    For example, A \n B vs. A X \n B X will be treated as two changes instead of one.

  • Highlight symbols: the modified symbols will be highlighted

  • Do not highlight: if this option is selected, the differences are not highlighted at all. This option is intended for significantly modified files, where highlighting only introduces additional difficulties.

the Collapse All button

Collapse unchanged fragments

Click this button to collapse all unchanged fragments in both files. The amount of non-collapsible unchanged lines is configurable in the Diff & Merge settings page.

the Synchronize button

Synchronize scrolling

Click this button to simultaneously scroll both differences panes; if this button is released, each of the panes can be scrolled independently.

the Settings button

Settings

Click this button to invoke the list of available settings. Select or clear these options to show or hide whitespaces, line numbers and indent guides, to use or disable the use of soft wraps, and to set the highlighting level.

These commands are also available from the context menu of the differences viewer gutter.

the External Tools icon

Show diff in external tool

Click this button to invoke an external differences viewer, specified in the External Diff Tools settings page.

This button only appears on the toolbar when the Use external diff tool option is enabled in the External Diff Tools settings page.

The most useful shortcuts in the Diff Pane are the following:

Shortcut

Description

Use this keyboard shortcut to show the popup menu of the most commonly used diff commands.

Ctrl+Tab

Use this keyboard shortcut to switch between the left and the right panes.

Ctrl+Shift+Tab

Use this keyboard shortcut to select the position obtained by Ctrl+Tab in the opposite pane.

Ctrl+Z/Ctrl+Shift+Z

Use this keyboard shortcut to undo/redo a merge operation. Conflicts will be kept in sync with the text.

Last modified: 28 February 2020