Sublimerge Pro (2.x) documentation

For developers

This chapter contains full list of all commands that can be run from other plugins or bound to key/mouse shortcuts.

Commands bound to keys

sublimerge [ctrl]+[alt]+[d]
Depending on context, displays list of available commands for current view, Differences Navigator (in files diff view), enters directory or diffs selected file (in directories diff view).
sublimerge_go_up [up]
Selects previous difference in diff view.

Applicable to diff view only.

sublimerge_go_down [down]
Selects next difference in diff view.

Applicable to diff view only.

sublimerge_merge_left [left], [shift]+[left]
Merges selected changes from right to left.

Applicable to diff view only.

sublimerge_merge_right [right], [shift]+[right]
Merges selected changes from left to right.

Applicable to diff view only.

sublimerge_toggle_edit [ctrl]+[enter]
Toggles edit mode on/off.

Applicable to diff view only.

sublimerge_diff_dir_or_file [enter]
Enters subdirectory or diffs selected text file.

Applicable to directories diff view only.

sublimerge_differences_navigator [/]
Displays Differences Navigator in diff view.

Applicable to diff view only.

Commands bound to mouse

sublimerge_select_region [ctrl]+[alt]+[left click]
Selects/deselects clicked changes.

Applicable to diff view only.

sublimerge_merge_left [ctrl]+[shift]+[right click]
Merges selected changes from right to left.

Applicable to diff view only.

sublimerge_merge_right [ctrl]+[shift]+[left click]
Merges selected changes from left to right.

Applicable to diff view only.

Other available commands

sublimerge_compare_to_view
Displays Quick Panel with list of comparable views.
sublimerge_show_unsaved_changes
Shows changes made in a view since last save. Works for dirty views only.
sublimerge_compare_to_view_selections
Displays Quick Panel with list of comparable views that contains single selection.
sublimerge_compare_to_revision
Displays Quick Panel with list of file revisions.
sublimerge_compare_revision_to_revision
Displays Quick Panel to compare two revisions with each other.
sublimerge_show_changes_in_revision
Displays Quick Panel to show changes introduced in selected revision.
sublimerge_compare_selections
Compares two selections in one view.
sublimerge_compare_to_snapshot
Displays Quick Panel to compare current view to its snapshots.
sublimerge_compare_to_clipboard
Compares a view to clipboard contents.
sublimerge_begin_edit
Changes diff mode to edit mode.

Applicable to diff view only.

sublimerge_end_edit
Changes edit mode to diff mode.

Applicable to diff view only.

sublimerge_swap_view
Swaps diff view.

Applicable to diff view only.

sublimerge_take_snapshot
Takes snapshot of current view.
sublimerge_restore_snapshot
Displays Quick Panel to restore view to selected snapshot.
sublimerge_remove_snapshot
Displays Quick Panel to remove selected snapshot.
sublimerge_replace_snapshot
Displays Quick Panel to replace selected snapshot with a new one.
sublimerge_diff
General-purpose command to compare files. This command may be used by other plugins' developers to show side-by-side diffs in Sublime Text. Accepts the following parameters:

  • For 2-way diff:
    • left - path to left file
    • right - path to right file
    • left_read_only - open left file in read-only mode (optional, defaults to false)
    • right_read_only - open right file in read-only mode (optional, defaults to false)
    • left_title - title for left pane (optional)
    • right_title - title for right pane (optional)
    • full_screen - True, False or None (optional, defaults to None - value from config)
  • For 3-way diff:
    • theirs - path to THEIRS file
    • base - path to BASE file
    • mine - path to MINE file
    • merged - path to MERGED (output) file
    • full_screen - True, False or None (optional, defaults to None - value from config)
I serve cookies to improve your experience on this website. If you continue without changing your browser settings, I will assume that you accept the cookies. You can change your browser settings at any time.