WebStorm 2016.1 Help

Log Tab

VCS | Show Changes View - Log
View | Tool Windows | Version Control - Log
N/A

The tab is only available if your project is integrated with Git or Mercurial.

This tab shows all changes committed to all branches of the local and remote repositories, or to a specific branch or repository.

The tab contains the following panes:

  • The Commits pane is located on the left of the tool window and shows the commits to all or selected branches from the local and remote repositories.
  • The Changed Files pane is located on the right of the tool window and shows the list of files that were modified and committed within the selected commit.

Commits Pane

The commits pane consists of three areas:

Commits

This area shows a list of all commits performed to the selected branch, or to all branches. For each commit, the list shows the commit message, the author, and the commit date. The latest commit in each branch is supplied with a color label with the name of the branch in which it was performed.

There are the following labels:

  • local (Mercurial) and regular (Git/Mercurial) for tags.
  • tip (Mercurial) for the latest revision in the repository.
  • HEAD (Git/Mercurial) for the current working revision.

For Git, the color of the label depends on the branch type (local or remote).

For Mercurial, there are different color labels for bookmarks, open heavy branches and closed heavy branches.

In multi-root projects, the colored stripe on the left indicates which root the selected commit belongs to (each root is marked with its own color). Hover the mouse cursor over the colored stripe to invoke a tip that shows the root path. You can also enable the Show Root Names option if you want to expand the Roots column with full root names.

Committed changelists often correspond to issues in tracking systems. You can jump to such issues in a browser right from the Commits pane. This functionality is available if:

  • The pattern of the bug tracking system is specified in the Issue Navigation Settings dialog box.
  • The corresponding issue number is mentioned in the commit message.

After issue navigation has been configured, issue numbers in commit messages are rendered as links. Clicking such link brings you to the corresponding page of your issue tracker.

Commit Details

This area is displayed when the Show Details show_details1 option is enabled.

This area shows the details on the commit selected in the Commits list, such as date, time, author, root and branches.

If the selected commit is contained in more than six branches, only the first six are displayed and the Show All link appears that you can click to expand a complete list of branches.

Toolbar

ItemTooltip and ShortcutDescription
Filter N/A Use this text box to search through the list of commits. You can enter full or parts of commit names or messages, or revision numbers. As you type, the commits containing your search string are displayed. To finalize the search, press Enter.
find3 N/A Click this button to show previously used search patterns.
clear.png N/A Click this button to clear the search history list.
Branch N/A Use this drop-down list to filter the commits by the branch. If you want to see commits from all local and remote branches, select All.
User N/A Use this drop-down list to filter the commits by the author. To view the commits of a specific author, click Select and start typing the author's name. To view commits by all users, select All.
Date N/A Use this drop-down list to filter the commits by a time-frame or a specific date. To view the commits made on a specific date, click Select and specify the date. To view commits made on all dates, select All.
Paths N/A Use this drop-down list to filter the commits by the folder (for projects that have one root), or by the root and folder (for multi-root projects). To view the commits to a specific folder, click Select Folders and specify the folder name. For multi-root projects, you can also select the check-box next to one or several roots in the Roots section.
intelliSort IntelliSort If this option is enabled, you get a more convenient way to view merges by displaying the incoming commits first, directly below the merge commit.
collapse_linear_branches Collapse linear branchesClick this button to collapse all branches on the graph so that a dotted line is shown instead of successive commits.
It is also possible to collapse an individual expanded branch by clicking it.
expand_linear_branches Expand all branchesClick this button to expand all collapsed branches to show successive commits on the graph.
It is also possible to expand an individual collapsed branch by clicking it.
show_long_edges Show long edges If this option is enabled, long branches are displayed in full, even if there are no commits in them. If this option is disabled (by default), long branches are replaced with a down arrow.
refresh.png Refresh
Ctrl+F5
Click this button to refresh the information in the Commits pane.
show_details1 Show details Click this button to show the Commit details pane.
find Go to Hash/Branch/Tag
Ctrl+F
Click this button and specify a hash, tag or branch you want to jump to in the text field.
vcs_find_hash_branch_tag_action
You can select a reference with the same name from different repositories. The name of each repository is displayed on the right side of the list along with its color indicator.
viewMode Quick settings Click this button to invoke one of the following commands:
  • Show Branches Panel: enable this option if you want a panel listing all branches to be displayed:
    branches_panel

    You can click on a label in the branches panel to jump to the corresponding branch in the Commits list.

  • Show Root Names: enable this option if you want to expand the Roots column on the left showing full root names. Note that this option is only available for multi-root projects.
    rootNames
  • Highlight My Commits: enable this option if you want your commits to be highlighted with the yellow background in the commits list.
    highlightMyCommits
cherryPickButton.png Cherry-pick (for Git)
Graft (for Mercurial)
Click this button to apply the changes from the selected commit to the current branch.
non_picked_commits Highlight non-picked commits Note that this command is only available if you are using Git as your version control system.

Click this button to highlight the commits from the selected branch that have not yet been applied to the current branch.

Context menu commands

ItemDescriptionAvailable in
Copy Revision Number copy Use this command to copy the revision number of the selected commit to the clipboard. Git
Mercurial
Create Patch iconCreatePatch.png Use this command to create a patch based on the selected commit. Git
Mercurial
Cherry-pick (Git)
Graft (Mercurial)
cherryPickButton.png
Use this command to apply the changes from the selected commit to the current branch. Git
Mercurial
Checkout Revision Use this command to check out the state of files recorded in the selected commit. Git
Update to Revision Use this command to change your working copy parent revision to the selected commit. New commits will carry on from the revision (commit) you update to. Mercurial
New Branch Use this command to create a new branch based on the selected commit. Git
Mercurial
New Tag Use this command to add a new tag to the selected commit. Git
Mercurial
Branch <branch_name> / Branches This command appears for all branches that point to the selected commit (Branch <branch_name> if there is one branch, or Branches if there are multiple branches) and provides the same options as the ones available from the Branches popup and submenu:
  • Checkout as new local branch
  • Compare
  • Rebase onto
  • Merge
  • Delete

If the Control repositories synchronously option is enabled, and the selected branch exists in multiple repositories, an additional menu option named In All Repositories appears that allows you to perform the same operations in all repositories simultaneously.

Reset Current Branch to Here Use the command to reset the current branch head to the selected commit. In the Git Reset dialog that opens, select the mode in which the working tree will be updated. Git
Open in GitHub openGitHub Use this command to open the page that corresponds to the selected commit on GitHub. Git
MQ Use this submenu to manage Mercurial Queues:
  • Import: use this command to turn the selected changeset into a patch.
  • Goto patch: use this command to open the MQ: <project_name> tab that shows a queue of patches that have not been applied yet.
  • Rename Patch: use this command to rename the selected patch.
  • Finish Patches: use this command to turn the selected patch into a permanent changeset.
Mercurial

Changed files pane

This pane shows a list of files that were modified within the currently selected commit.

Toolbar

Many of the options available in the toolbar are duplicated in the context menu.
ItemTooltip and ShortcutDescription
img Show Diff
Ctrl+D
Click this button to open the Differences Viewer where you can compare the current and the previous revision of the selected file.
img Show Diff with Local Click this button to show the differences between the selected revision of the selected file and its current local copy.
edit Edit Source
F4
Click this button to open the local copy of the selected file for editing.
img Open Repository Version Click this button to open the repository version of the selected file for editing.
rollback Revert Selected Changes Click this button to roll back the changes in the selected file.
groupByPackage Group by Directory
Ctrl+P
Click this button to transform a flat list of files into a tree of packages with files.
expandAll.png collapseAll Expand All/Collapse All
Ctrl+NumPad Plus
Click this button to expand/collapse all nodes.

Note that these buttons are only available only when tree-view is enabled.

Context menu commands

ItemTooltip and ShortcutDescription
img Show Diff
Ctrl+D
Click this button to open the Differences Viewer where you can compare the current and the previous revision of the selected file.
img Show Diff with Local Click this button to show the differences between the selected revision of the selected file and its current local copy.
edit Edit Source
F4
Click this button to open the local copy of the selected file for editing.
img Open Repository Version Click this button to open the repository version of the selected file for editing.
rollback Revert Selected Changes Click this button to roll back the changes in the selected file.

See Also

Last modified: 11 July 2016