@ -6,12 +6,12 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [8.0.0-beta2] - 2018-02-02
### Added
- Adds an all-new GitLens welcome page via the *Welcome* (`gitlens.showWelcomePage`) command -- provides a welcome / onboarding experience
- Adds an all-new GitLens Settings editor via the *Open Settings* (`gitlens.showSettingsPage`) command -- provides an easy-to-use WYSIWYG settings editor for many of GitLen's features
- Adds an all-new GitLens welcome page via the *Welcome* (`gitlens.showWelcomePage`) command — provides a welcome / onboarding experience
- Adds an all-new GitLens Settings editor via the *Open Settings* (`gitlens.showSettingsPage`) command — provides an easy-to-use WYSIWYG settings editor for many of GitLen's features
- Adds `gitlens.hovers.enabled` setting to specify whether or not to provide any hovers
- Adds `gitlens.hovers.annotations.enabled` setting to specify whether or not to provide any hovers when showing blame annotations
- Adds `gitlens.hovers.currentLine.enabled` setting to specify whether or not to provide any hovers for the current line
- Adds `debug` option to the `gitlens.outputLevel` setting -- outputs git commands to a new output channel called *GitLens (Git)*
- Adds `debug` option to the `gitlens.outputLevel` setting — outputs git commands to a new output channel called *GitLens (Git)*
### Changed
- Renames *GitLens* view to *GitLens* explorer
@ -72,7 +72,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [7.5.10] - 2018-02-01
### Added
- Adds support for custom remotes with split project/repo url structure -- closes [#267](https://github.com/eamodio/vscode-gitlens/issues/267)
- Adds support for custom remotes with split project/repo url structure — closes [#267](https://github.com/eamodio/vscode-gitlens/issues/267)
### Fixed
- Fixes [#266](https://github.com/eamodio/vscode-gitlens/issues/266) - Wrong time in Popup
@ -102,7 +102,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
### Changed
- Changes `chorded` keymap on Windows to use `Ctrl+Shift+G` rather than `Ctrl+Alt+G` to avoid [issues](https://blogs.msdn.microsoft.com/oldnewthing/20040329-00/?p=40003)
- Also remaps `Show SCM` to `Ctrl+Shift+G G` since by default it is `Ctrl+Shift+G` if the `chorded` keymap is used
- Refactors git log and stash output parsing -- should be faster and far more robust
- Refactors git log and stash output parsing — should be faster and far more robust
### Fixed
- Fixes [#256](https://github.com/eamodio/vscode-gitlens/issues/256) - Fails to copy commit message
@ -136,10 +136,10 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
### Added
- Adds [Gravatar](https://en.gravatar.com/) support to gutter and hover blame annotations
- Adds `gitlens.annotations.file.gutter.gravatars` setting to specify whether or not to show gravatar images in the gutter blame annotations
- Adds support for providing blame annotations, code lens, etc on files with unsaved changes -- closes [#112](https://github.com/eamodio/vscode-gitlens/issues/112)
- Adds `gitlens.defaultDateStyle` setting to specify how dates will be displayed by default -- closes [#89](https://github.com/eamodio/vscode-gitlens/issues/89)
- Adds support for providing blame annotations, code lens, etc on files with unsaved changes — closes [#112](https://github.com/eamodio/vscode-gitlens/issues/112)
- Adds `gitlens.defaultDateStyle` setting to specify how dates will be displayed by default — closes [#89](https://github.com/eamodio/vscode-gitlens/issues/89)
- Adds *Compare with Working Tree* command (`gitlens.explorers.compareWithWorking`) to branch, tag, and revision (commit) nodes in the **GitLens** view to compare the current selection with the current working tree in the **GitLens Results** view
- Adds *Compare Selected Ancestor with Working Tree* command (`gitlens.explorers.compareSelectedAncestorWithWorking`) to branch nodes in the **GitLens** view once another branch within the same repository has been selected to compare the [merge base](https://git-scm.com/docs/git-merge-base) of current and previously selected branches with the working tree in the **GitLens Results** view -- closes [#240](https://github.com/eamodio/vscode-gitlens/issues/240)
- Adds *Compare Selected Ancestor with Working Tree* command (`gitlens.explorers.compareSelectedAncestorWithWorking`) to branch nodes in the **GitLens** view once another branch within the same repository has been selected to compare the [merge base](https://git-scm.com/docs/git-merge-base) of current and previously selected branches with the working tree in the **GitLens Results** view — closes [#240](https://github.com/eamodio/vscode-gitlens/issues/240)
- Adds *Merge Branch (via Terminal)* command (`gitlens.explorers.terminalMergeBranch`) to branch nodes in the **GitLens** view
- Adds *Rebase (Interactive) Branch (via Terminal)* command (`gitlens.explorers.terminalRebaseBranch`) to branch nodes in the **GitLens** view
- Adds *Cherry Pick Commit (via Terminal)* command (`gitlens.explorers.terminalRebaseBranch`) to revision (commit) nodes in the **GitLens**&**GitLens Results** views
@ -159,7 +159,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
### Fixed
- Fixes issue where the **GitLens Results** view wouldn't properly update when replacing existing results
- Fixes issue where showing commit search (file-based) results in the **GitLens Results** view wouldn't only show the matching files -- closes [#197](https://github.com/eamodio/vscode-gitlens/issues/197)
- Fixes issue where showing commit search (file-based) results in the **GitLens Results** view wouldn't only show the matching files — closes [#197](https://github.com/eamodio/vscode-gitlens/issues/197)
- Fixes [#238](https://github.com/eamodio/vscode-gitlens/issues/238) - Show merge commits in file history
- Fixes issue where the Tags node of the **GitLens** view wasn't updated on changes
- Fixes issue where changes to .gitignore weren't detected properly
@ -170,11 +170,11 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [7.2.0] - 2018-01-01
### Added
- Adds on-demand **heatmap annotations** of the whole file -- closes [#182](https://github.com/eamodio/vscode-gitlens/issues/182)
- Adds on-demand **heatmap annotations** of the whole file — closes [#182](https://github.com/eamodio/vscode-gitlens/issues/182)
- Displays a **heatmap** (age) indicator near the gutter, which provides an easy, at-a-glance way to tell the age of a line
- Indicator ranges from bright yellow (newer) to dark brown (older)
- Adds *Toggle File Heatmap Annotations* command (`gitlens.toggleFileHeatmap`) to toggle the heatmap annotations on and off
- Adds semi-persistent results for commit operations, via the *Show Commit Details* command (`gitlens.showQuickCommitDetails`) in the **GitLens Results** view -- closes [#237](https://github.com/eamodio/vscode-gitlens/issues/237)
- Adds semi-persistent results for commit operations, via the *Show Commit Details* command (`gitlens.showQuickCommitDetails`) in the **GitLens Results** view — closes [#237](https://github.com/eamodio/vscode-gitlens/issues/237)
- Adds *Show in Results* option to the commit details quick pick menu to show the commit in the **GitLens Results** view
- Adds *Compare with Index (HEAD)* command (`gitlens.explorers.compareWithHead`) to branch, tag, and revision (commit) nodes in the **GitLens** view to compare the current selection with the current index (HEAD) in the **GitLens Results** view
- Adds *Compare with Remote* command (`gitlens.explorers.compareWithRemote`) to branch nodes in the **GitLens** view to compare the current selection with its remote tracking branch in the **GitLens Results** view
@ -188,12 +188,12 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [7.1.0] - 2017-12-22
### Added
- Adds *Open Working File* command (`gitlens.openWorkingFile`) - opens the working file for the active file revision -- closes [#236](https://github.com/eamodio/vscode-gitlens/issues/236)
- Adds *Open Working File* command (`gitlens.openWorkingFile`) - opens the working file for the active file revision — closes [#236](https://github.com/eamodio/vscode-gitlens/issues/236)
- Adds *Open Revision...* command (`gitlens.openFileRevision`) - opens the selected revision for the active file
- Adds tags to the *Compare File with Branch...* command (`gitlens.diffWithBranch`) -- closes [#204](https://github.com/eamodio/vscode-gitlens/issues/204)
- Adds tags to the *Directory Compare Working Tree with...* command (`gitlens.diffDirectory`) -- closes [#204](https://github.com/eamodio/vscode-gitlens/issues/204)
- Adds *Show Branches and Tags* to quick pick menu shown by the *Compare File with Revision...* command (`gitlens.diffWithRevision`) -- closes [#204](https://github.com/eamodio/vscode-gitlens/issues/204)
- Adds *Show Branches and Tags* to quick pick menu shown by the *Open Revision...* command (`gitlens.openFileRevision`) -- closes [#204](https://github.com/eamodio/vscode-gitlens/issues/204)
- Adds tags to the *Compare File with Branch...* command (`gitlens.diffWithBranch`) — closes [#204](https://github.com/eamodio/vscode-gitlens/issues/204)
- Adds tags to the *Directory Compare Working Tree with...* command (`gitlens.diffDirectory`) — closes [#204](https://github.com/eamodio/vscode-gitlens/issues/204)
- Adds *Show Branches and Tags* to quick pick menu shown by the *Compare File with Revision...* command (`gitlens.diffWithRevision`) — closes [#204](https://github.com/eamodio/vscode-gitlens/issues/204)
- Adds *Show Branches and Tags* to quick pick menu shown by the *Open Revision...* command (`gitlens.openFileRevision`) — closes [#204](https://github.com/eamodio/vscode-gitlens/issues/204)
### Changed
- Improves startup performance by ~65% (on my very fast PC) and reduces package size by over 75%
@ -206,11 +206,11 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [7.0.0] - 2017-12-18
### Added
- Adds a new **Active Repository** node to the **Repository View** of the **GitLens** view -- closes [#224](https://github.com/eamodio/vscode-gitlens/issues/224)
- Adds a new **Active Repository** node to the **Repository View** of the **GitLens** view — closes [#224](https://github.com/eamodio/vscode-gitlens/issues/224)
- Automatically updates to track the repository of the active editor
- Only visible if there is more than 1 repository within the workspace
- Adds a new **Tags** node to the **Repository View** of the **GitLens** view -- closes [#234](https://github.com/eamodio/vscode-gitlens/issues/234)
- Adds a new **Tags** node to the **Repository View** of the **GitLens** view — closes [#234](https://github.com/eamodio/vscode-gitlens/issues/234)
- Provides a list of tags
- Expand each tag to easily see its revision (commit) history
- Expand each revision (commit) to quickly see the set of files changed, complete with status indicators for adds, changes, renames, and deletes
@ -236,17 +236,17 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Provides a context menu on each changed file with *Open Changes*, *Open Changes with Working Tree*, *Open File*, *Open Revision*, *Open File in Remote*, *Open Revision in Remote*, *Apply Changes*, and *Show Commit File Details* commands
- Provides semi-persistent results for revision comparison operations, via the *Select for Compare* command (`gitlens.explorers.selectForCompare`) and the *Compare with Selected* command (`gitlens.explorers.compareWithSelected`)
- **Commits** node — provides a list of the commits between the compared revisions (branches or commits)
- **Commits** node — provides a list of the commits between the compared revisions (branches or commits)
- Expand each revision (commit) to quickly see the set of files changed, complete with status indicators for adds, changes, renames, and deletes
- Provides a context menu on each revision (commit) with *Open Commit in Remote*, *Open All Changes*, *Open All Changes with Working Tree*, *Open Files*, *Open Revisions*, *Copy Commit ID to Clipboard*, *Copy Commit Message to Clipboard*, *Show Commit Details*, *Compare with Selected*, *Select for Compare*, *Rebase Commit (via Terminal)*, *Reset Commit (via Terminal)*, and *Refresh* commands
- Provides a context menu on each changed file with *Open Changes*, *Open Changes with Working Tree*, *Open File*, *Open Revision*, *Open File in Remote*, *Open Revision in Remote*, *Apply Changes*, and *Show Commit File Details* commands
- **Changed Files** node — provides a list of all the files changed between the compared revisions (branches or commits)
- **Changed Files** node — provides a list of all the files changed between the compared revisions (branches or commits)
- Expands to a file-based view of all changed files
- Provides a context menu on each changed file with *Open Changes*, *Open Changes with Working Tree*, *Open File*, *Open Revision*, *Open File in Remote*, *Open Revision in Remote*, *Apply Changes*, and *Show Commit File Details* commands
- Provides a context menu with *Open Directory Compare* and *Refresh* commands
- Provides toolbar commands to *Search Commits*, *Keep Results*, *Refresh*, *Show Files in Automatic View* or *Show Files in List View* or *Show Files in Tree View*, and *Close*
- Adds *Apply Changes* option to the commit/stash file quick pick menu -- closes [#232](https://github.com/eamodio/vscode-gitlens/issues/232)
- Adds *Apply Changes* option to the commit/stash file quick pick menu — closes [#232](https://github.com/eamodio/vscode-gitlens/issues/232)
- Adds *Show All Commits* option to the commit search quick pick menu to show all the results, if there are more than the threshold
- Adds *Show in Results* option to the commit search quick pick menu to show the results in the **GitLens Results** view
- Adds *Show in Results* option to the file history quick pick menu to show the history in the **GitLens Results** view
@ -259,14 +259,14 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
### Fixed
- Fixes [#228](https://github.com/eamodio/vscode-gitlens/issues/228) - Gutter blame spills over heatmap
- Fixes incorrect blame highlighting -- thanks to [PR #231](https://github.com/eamodio/vscode-gitlens/pull/231) by Alexey Vasyukov ([@notmedia](https://github.com/notmedia))!
- Fixes incorrect blame highlighting — thanks to [PR #231](https://github.com/eamodio/vscode-gitlens/pull/231) by Alexey Vasyukov ([@notmedia](https://github.com/notmedia))!
- Fixes issue with the *Open in File/Revision* option in the file history quick pick menu
- Fixes issues with Git warnings when parsing log status output (can cause the **GitLens** view to not show data in some cases)
- Fixes 🤞 [#226](https://github.com/eamodio/vscode-gitlens/issues/226) - Annotations show in Debug Console
## [6.4.0] - 2017-12-12
### Added
- Adds `gitlens.keymap` setting to specify the keymap to use for GitLens shortcut keys -- closes [#104](https://github.com/eamodio/vscode-gitlens/issues/104)
- Adds `gitlens.keymap` setting to specify the keymap to use for GitLens shortcut keys — closes [#104](https://github.com/eamodio/vscode-gitlens/issues/104)
- `standard` - adds a standard set of shortcut keys
- `chorded` - adds a chorded set of shortcut keys that all start with `Ctrl+Alt+G` (`⌥⌘G` on macOS)
- `none` - no shortcut keys will be added
@ -340,11 +340,11 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [6.1.0] - 2017-11-13
### Added
- Adds support for nested repositories and submodules -- closes [#198](https://github.com/eamodio/vscode-gitlens/issues/198)
- Adds support for nested repositories and submodules — closes [#198](https://github.com/eamodio/vscode-gitlens/issues/198)
- Adds `gitlens.advanced.repositorySearchDepth` setting to specify how many folders deep to search for repositories
### Changed
- Changes to use `diff.guitool` first if available, before falling back to `diff.tool`-- closes [#195](https://github.com/eamodio/vscode-gitlens/issues/195)
- Changes to use `diff.guitool` first if available, before falling back to `diff.tool`— closes [#195](https://github.com/eamodio/vscode-gitlens/issues/195)
### Fixed
- Fixes issue where failed git commands would get stuck in the pending queue causing future similar commands to also fail
@ -353,7 +353,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [6.0.0] - 2017-11-08
### Added
- Adds multi-root workspace support -- [Learn more](https://code.visualstudio.com/docs/editor/multi-root-workspaces)
- Adds multi-root workspace support — [Learn more](https://code.visualstudio.com/docs/editor/multi-root-workspaces)
- Adds new logo/icon
- Adds indicator dots on the branch node(s) of the **GitLens** view which denote the following:
- *None* - no upstream or up-to-date with the upstream
@ -361,10 +361,10 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- *Red* - behind the upstream
- *Yellow* - both ahead of and behind the upstream
- Adds progress indicator to the *Search Commits* command (`gitlens.showCommitSearch`)
- Adds code search support to the *Search Commits* command (`gitlens.showCommitSearch`) -- closes [#127](https://github.com/eamodio/vscode-gitlens/issues/127)
- Adds code search support to the *Search Commits* command (`gitlens.showCommitSearch`) — closes [#127](https://github.com/eamodio/vscode-gitlens/issues/127)
- Use `~<regex>` to search for commits with differences whose patch text contains added/removed lines that match `<regex>`
- Use `=<regex>` to search for commits with differences that change the number of occurrences of the specified string (i.e. addition/deletion) in a file
- Adds support to the *Compare File with Branch...* command (`gitlens.diffWithBranch`) work with renamed files -- closes [#165](https://github.com/eamodio/vscode-gitlens/issues/165)
- Adds support to the *Compare File with Branch...* command (`gitlens.diffWithBranch`) work with renamed files — closes [#165](https://github.com/eamodio/vscode-gitlens/issues/165)
- Adds *Compare File with Branch...* command (`gitlens.diffWithBranch`) to source control resource context menu
- Adds *Open Repository in Remote* command (`gitlens.openRepoInRemote`) to repository node(s) of the **GitLens** view
- Adds *Enable Automatic Refresh* command (`gitlens.gitExplorer.setAutoRefreshToOn`) to the **GitLens** view regardless of the current view
@ -378,10 +378,10 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Adds *Rebase Commit (via Terminal)* command (`gitlens.terminalRebaseCommit`) to commit node(s) of the **GitLens** view
- Adds *Reset Commit (via Terminal)* command (`gitlens.terminalResetCommit`) to commit node(s) of the **GitLens** view
- Adds *Remove Remote (via Terminal)* command (`gitlens.terminalRemoveRemote`) to remote node(s) of the **GitLens** view
- Adds ability to specify the url protocol used with user-defined remote services via `gitlens.remotes` setting -- thanks to [PR #192](https://github.com/eamodio/vscode-gitlens/pull/192) by Helmut Januschka ([@hjanuschka](https://github.com/hjanuschka))!
- Adds ability to specify the url protocol used with user-defined remote services via `gitlens.remotes` setting — thanks to [PR #192](https://github.com/eamodio/vscode-gitlens/pull/192) by Helmut Januschka ([@hjanuschka](https://github.com/hjanuschka))!
### Changed
- **GitLens** view will no longer show if there is no Git repository -- closes [#159](https://github.com/eamodio/vscode-gitlens/issues/159)
- **GitLens** view will no longer show if there is no Git repository — closes [#159](https://github.com/eamodio/vscode-gitlens/issues/159)
- Optimizes event handling, executing git commands, and general processing to improve performance and reduce any lag
- Optimizes current line hover annotations to only be computed on hover (i.e. lazily evaluated) to reduce the compute required when changing lines
- Protects credentials from possibly being affected by poor network conditions via Git Credential Manager (GCM) for Windows environment variables
@ -401,7 +401,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [5.7.0] - 2017-10-19
### Added
- Adds *Open All Changes (with difftool)* command (`gitlens.externalDiffAll`) - opens all working changes with the configured git difftool -- closes [#164](https://github.com/eamodio/vscode-gitlens/issues/164)
- Adds *Open All Changes (with difftool)* command (`gitlens.externalDiffAll`) - opens all working changes with the configured git difftool — closes [#164](https://github.com/eamodio/vscode-gitlens/issues/164)
- Also adds the command to the Source Control group context menu
- Adds `gitlens.gitExplorer.autoRefresh` setting to specify whether or not to automatically refresh the **GitLens** view when the repository or the file system changes
- Adds *Enable Automatic Refresh* command (`gitlens.gitExplorer.setAutoRefreshToOn`) to enable the automatic refresh of the **GitLens** view
@ -460,7 +460,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
### Removed
- Removes `Custom` from the `gitlens.codeLens.locations` setting as it wasn't really required
- Removes properties (symbol `Property`) from being included in the `Blocks` option of the `gitlens.codeLens.locations` setting -- can be easily re-added by setting `"gitlens.codeLens.customLocationSymbols": [ "Property" ]` if desired
- Removes properties (symbol `Property`) from being included in the `Blocks` option of the `gitlens.codeLens.locations` setting — can be easily re-added by setting `"gitlens.codeLens.customLocationSymbols": [ "Property" ]` if desired
- Removes `gitlens.annotations.file.hover.wholeLine` setting as it didn't really make sense
### Fixed
@ -471,11 +471,11 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
### Added
- Adds a **quick-access** command bar to the bottom of the **details** hover annotations
- Provides *Open Changes*, *Blame Previous Revision*, *Open in Remote*, and *Show More Actions* command buttons
- Adds support for remembering file annotations when switching tabs
- Adds full GitLens support for file revisions -- file & line annotations, commands, etc
- Adds full GitLens support for file revisions — file & line annotations, commands, etc
### Changed
- Changes `gitlens.annotations.file.gutter.hover.wholeLine` setting to default to `true`
@ -487,23 +487,23 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Removes `"gitlens.showBlameHistory"`&`"gitlens.showFileHistory"` option from `gitlens.codeLens.recentChange.command` setting
- Removes `"gitlens.showBlameHistory"`&`"gitlens.showFileHistory"` option from `gitlens.codeLens.authors.command` setting
- Removes `"gitlens.showBlameHistory"`&`"gitlens.showFileHistory"` option from `gitlens.statusBar.command` setting
- Removes `gitlens.advanced.toggleWhitespace.enabled` setting -- as it is no longer required
- Removes `gitlens.advanced.toggleWhitespace.enabled` setting — as it is no longer required
### Fixed
- Fixes [#161](https://github.com/eamodio/vscode-gitlens/issues/161) - Remove colors from output of git command calls
## [5.4.1] - 2017-10-03
### Changed
- Changes annotation hovers to only add *Open in Remote* and *Show Commit Details* commands when applicable -- thanks to [PR #158](https://github.com/eamodio/vscode-gitlens/pull/158) by SpaceEEC ([@SpaceEEC](https://github.com/SpaceEEC))!
- Changes annotation hovers to only add *Open in Remote* and *Show Commit Details* commands when applicable — thanks to [PR #158](https://github.com/eamodio/vscode-gitlens/pull/158) by SpaceEEC ([@SpaceEEC](https://github.com/SpaceEEC))!
### Fixed
- Fixes issue where **Changes** hover annotation displayed incorrect info when there was no previous commit -- thanks to [PR #158](https://github.com/eamodio/vscode-gitlens/pull/158) by SpaceEEC ([@SpaceEEC](https://github.com/SpaceEEC))!
- Fixes issue where **Changes** hover annotation displayed incorrect info when there was no previous commit — thanks to [PR #158](https://github.com/eamodio/vscode-gitlens/pull/158) by SpaceEEC ([@SpaceEEC](https://github.com/SpaceEEC))!
- Fixes issue when checking for remotes could return no remotes even if remotes are configured
## [5.4.0] - 2017-09-30
### Added
- Adds support for user-defined remote services via `gitlens.remotes` setting -- closes [#148](https://github.com/eamodio/vscode-gitlens/issues/148)
- Adds *Open Changes (with difftool)* command (`gitlens.externalDiff`) - opens the changes of a file or set of files with the configured git difftool -- thanks to [PR #154](https://github.com/eamodio/vscode-gitlens/pull/154) by Chris Kaczor ([@ckaczor](https://github.com/ckaczor))!
- Adds support for user-defined remote services via `gitlens.remotes` setting — closes [#148](https://github.com/eamodio/vscode-gitlens/issues/148)
- Adds *Open Changes (with difftool)* command (`gitlens.externalDiff`) - opens the changes of a file or set of files with the configured git difftool — thanks to [PR #154](https://github.com/eamodio/vscode-gitlens/pull/154) by Chris Kaczor ([@ckaczor](https://github.com/ckaczor))!
- Adds to the source control group and source control resource context menus
## [5.3.0] - 2017-09-26
@ -525,7 +525,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [5.2.0] - 2017-09-23
### Added
- Adds new **Changed Files** node to the **Repository Status** node of the **GitLens** view's **Repository View**-- closes [#139](https://github.com/eamodio/vscode-gitlens/issues/139)
- Adds new **Changed Files** node to the **Repository Status** node of the **GitLens** view's **Repository View**— closes [#139](https://github.com/eamodio/vscode-gitlens/issues/139)
- Provides a at-a-glance view of all "working" changes
- Expands to a file-based view of all changed files in the working tree (enabled via `"gitlens.insiders": true`) and/or all files in all commits ahead of the upstream
- Adds optional (on by default) working tree status information to the **Repository Status** node in the **GitLens** view
@ -538,16 +538,16 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Changes the sorting (now alphabetical) of files shown in the **GitLens** view
- Changes the default of the `gitlens.gitExplorer.view` setting to `auto`
- Changes the default of the `gitlens.gitExplorer.commitFormat` setting to add parentheses around the commit id
- Removes many menu items from `editor/title`&`editor/title/context` by default -- can be re-enabled via the `gitlens.advanced.menus` setting
- Removes many menu items from `editor/title`&`editor/title/context` by default — can be re-enabled via the `gitlens.advanced.menus` setting
- Fixes an issue when running *Open File in Remote* with a multi-line selection wasn't properly opening the selection in GitLab -- thanks to [PR #145](https://github.com/eamodio/vscode-gitlens/pull/145) by Amanda Cameron ([@AmandaCameron](https://github.com/AmandaCameron))!
- Fixes an issue when running *Open File in Remote* with a multi-line selection wasn't properly opening the selection in GitLab — thanks to [PR #145](https://github.com/eamodio/vscode-gitlens/pull/145) by Amanda Cameron ([@AmandaCameron](https://github.com/AmandaCameron))!
- Fixes an issue where the `gitlens.advanced.menus` setting wasn't controlling all the menu items properly
## [5.1.0] - 2017-09-15
### Added
- Adds full (multi-line) commit message to the **details** hover annotations -- closes [#116](https://github.com/eamodio/vscode-gitlens/issues/116)
- Adds full (multi-line) commit message to the **details** hover annotations — closes [#116](https://github.com/eamodio/vscode-gitlens/issues/116)
- Adds an external link icon to the **details** hover annotations to run the *Open Commit in Remote* command (`gitlens.openCommitInRemote`)
### Changed
@ -567,9 +567,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- **Repository View** - provides a full repository explorer
- **Repository Status** node — provides the status of the repository
- **Repository Status** node — provides the status of the repository
- Provides the name of the current branch, its upstream tracking branch (if available), and its upstream status (if available)
- Provides indicator dots on the repository icon which denote the following:
- *None* - up-to-date with the upstream
@ -579,7 +579,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Provides additional nodes, if the current branch is not synchronized with the upstream, to quickly see and explore the specific commits ahead and/or behind the upstream
- Provides a context menu with *Open Repository in Remote*, and *Refresh* commands
- **Branches** node — provides a list of the local branches
- **Branches** node — provides a list of the local branches
- Indicates which branch is the current branch and optionally shows the remote tracking branch
- Expand each branch to easily see its revision (commit) history
- Expand each revision (commit) to quickly see the set of files changed, complete with status indicators for adds, changes, renames, and deletes
@ -588,7 +588,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Provides a context menu on each branch with *Open Branch in Remote*, and *Refresh* commands
- Provides a context menu with *Open Branches in Remote*, and *Refresh* commands
- **Remotes** node — provides a list of remotes
- **Remotes** node — provides a list of remotes
- Indicates the direction of the remote (fetch, push, both), remote service (if applicable), and repository path
- Expand each remote to see its list of branches
- Expand each branch to easily see its revision (commit) history
@ -598,7 +598,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Provides a context menu on each remote with *Open Branches in Remote*, *Open Repository in Remote*, and *Refresh* commands
- Provides a context menu with a *Refresh* command
- **Stashes** node — provides a list of stashed changes
- **Stashes** node — provides a list of stashed changes
- Expand each stash to quickly see the set of files stashed, complete with status indicators for adds, changes, renames, and deletes
- Provides a context menu with *Stash Changes*, and *Refresh* commands
- Provides a context menu on each stash with *Apply Stashed Changes* (confirmation required), *Delete Stashed Changes* (confirmation required), *Open All Changes*, *Open All Changes with Working Tree*, *Open Files*, *Open Revisions*, *Copy Commit Message to Clipboard*, and *Refresh* commands
@ -606,7 +606,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- **History View** - provides the revision history of the active file
- Automatically updates to track the active editor
- Provides a context menu with *Open File*, *Open File in Remote*, and *Refresh* commands
@ -617,7 +617,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Adds all-new interactivity to the hover annotations
- Adds the following command-links to the **details** hover annotation
- Clicking the commit id will run the *Show Commit Details* command (`gitlens.showQuickCommitDetails`)
@ -625,13 +625,13 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Clicking on **Changes** will run the *Compare File Revisions* command (`gitlens.diffWith`)
- Clicking the current and previous commit ids will run the *Show Commit Details* command (`gitlens.showQuickCommitDetails`)
- Adds support for remote services with custom domains -- closes [#120](https://github.com/eamodio/vscode-gitlens/issues/120)
- Adds support for the Bitbucket Server (previously called Stash) remote service -- closes [#120](https://github.com/eamodio/vscode-gitlens/issues/120)
- Adds `gitlens.blame.ignoreWhitespace` setting to specify whether or not to ignore whitespace when comparing revisions during blame operations -- closes [#138](https://github.com/eamodio/vscode-gitlens/issues/138)
- Adds support for remote services with custom domains — closes [#120](https://github.com/eamodio/vscode-gitlens/issues/120)
- Adds support for the Bitbucket Server (previously called Stash) remote service — closes [#120](https://github.com/eamodio/vscode-gitlens/issues/120)
- Adds `gitlens.blame.ignoreWhitespace` setting to specify whether or not to ignore whitespace when comparing revisions during blame operations — closes [#138](https://github.com/eamodio/vscode-gitlens/issues/138)
- Adds *Open Branches in Remote* command (`gitlens.openBranchesInRemote`) - opens the branches in the supported remote service
- Adds *Stash Changes* command (`gitlens.stashSave`) to the source control group context menu -- can now stash a group of files
- Adds *Stash Changes* command (`gitlens.stashSave`) to the source control resource context menu -- can now stash individual files (works with multi-select too!)
- Adds *Stash Changes* command (`gitlens.stashSave`) to the source control group context menu — can now stash a group of files
- Adds *Stash Changes* command (`gitlens.stashSave`) to the source control resource context menu — can now stash individual files (works with multi-select too!)
- Adds `gitlens.gitExplorer.view` setting to specify the starting view (mode) of the **GitLens** view
- Adds `gitlens.gitExplorer.showTrackingBranch` setting to specify whether or not to show the tracking branch when displaying local branches in the **GitLens** view
- Adds `gitlens.gitExplorer.commitFormat` setting to specify the format of committed changes in the **GitLens** view
@ -653,7 +653,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Removes **Git Stashes** view - as it's functionality has been folded into the new **GitLens** view
- Removes *Stash Unstaged Changes* option from stashed changes quick pick menu -- didn't work as intended
- Removes *Stash Unstaged Changes* option from stashed changes quick pick menu — didn't work as intended
- Removes the seeding of the commit search command from the clipboard
### Fixed
@ -677,14 +677,14 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [4.4.0] - 2017-08-18
## Added
- Adds a progress indicator to the *Toggle File Blame Annotations* command (`gitlens.toggleFileBlame`) icon -- pulses while annotations are computed
- Adds an active state to the *Toggle File Blame Annotations* command (`gitlens.toggleFileBlame`) icon -- turns orange while the annotations are visible
- Adds automatic disabling of the current line blame annotations when starting a debug session and will restore them when the debug session ends -- can still be manually toggled via the *Toggle Line Blame Annotations* command (`gitlens.toggleLineBlame`)
- Adds a progress indicator to the *Toggle File Blame Annotations* command (`gitlens.toggleFileBlame`) icon — pulses while annotations are computed
- Adds an active state to the *Toggle File Blame Annotations* command (`gitlens.toggleFileBlame`) icon — turns orange while the annotations are visible
- Adds automatic disabling of the current line blame annotations when starting a debug session and will restore them when the debug session ends — can still be manually toggled via the *Toggle Line Blame Annotations* command (`gitlens.toggleLineBlame`)
## Changed
- Changes chat links from Gitter to [Slack](https://join.slack.com/t/vscode-gitlens/shared_invite/MjIxOTgxNDE3NzM0LTE1MDE2Nzk1MTgtMjkwMmZjMzcxNQ)
- Changes the look of the line separators on the gutter blame annotations
- Changes the `gitlens.advanced.toggleWhitespace.enabled` configuration setting to default to `false`-- thanks to the awesome work in vscode by Alexandru Dima ([@alexandrudima](https://github.com/alexandrudima)) this is no longer required!
- Changes the `gitlens.advanced.toggleWhitespace.enabled` configuration setting to default to `false`— thanks to the awesome work in vscode by Alexandru Dima ([@alexandrudima](https://github.com/alexandrudima)) this is no longer required!
## Removed
- Removes unneeded `gitlens.stashExplorer.enabled` configuration setting since users can add or remove views natively now
@ -706,7 +706,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [4.3.2] - 2017-07-20
## Fixed
- Fixes [#118](https://github.com/eamodio/vscode-gitlens/issues/118) - GitLens stopped working on latest insiders build -- thanks to [PR #121](https://github.com/eamodio/vscode-gitlens/pull/121) by Johannes Rieken ([@jrieken](https://github.com/jrieken))
- Fixes [#118](https://github.com/eamodio/vscode-gitlens/issues/118) - GitLens stopped working on latest insiders build — thanks to [PR #121](https://github.com/eamodio/vscode-gitlens/pull/121) by Johannes Rieken ([@jrieken](https://github.com/jrieken))
## [4.3.1] - 2017-07-03
## Added
@ -800,7 +800,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Adds all-new configurability to the status bar blame information
- Can now fully customize the [layout and content](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens#status-bar-settings)
- Adds all-new [configurability](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens#advanced-settings) over which commands are added to which menus via the `gitlens.advanced.menus` setting
- Adds better [configurability](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens#code-lens-settings) over where Git code lens will be shown -- both by default and per language
- Adds better [configurability](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens#code-lens-settings) over where Git code lens will be shown — both by default and per language
- Adds an all-new **changes** (diff) hover annotation to the current line - provides instant access to the line's previous version
- Adds *Toggle Line Blame Annotations* command (`gitlens.toggleLineBlame`) - toggles the current line blame annotations on and off
- Adds *Show Line Blame Annotations* command (`gitlens.showLineBlame`) - shows the current line blame annotations
@ -821,7 +821,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Changes the default of `gitlens.advanced.toggleWhitespace.enabled` back to `true`, but automatically disables whitespace toggling if whitespace rendering is not on
### Removed
- Removes the on-demand **trailing** file blame annotations -- didn't work out and just ended up with a ton of visual noise
- Removes the on-demand **trailing** file blame annotations — didn't work out and just ended up with a ton of visual noise
- Removes *Toggle Blame Annotations* command (`gitlens.toggleBlame`) - replaced by the *Toggle File Blame Annotations* command (`gitlens.toggleFileBlame`)
- Removes *Show Blame Annotations* command (`gitlens.showBlame`) - replaced by the *Show File Blame Annotations* command (`gitlens.showFileBlame`)
@ -842,7 +842,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
### Changed
- Changes the behavior of the *Compare File with Working Tree* command (`gitlens.diffWithWorking`) - always does what it says :)
- Compares the current file with the working tree -- if the current file *is* the working file, it will show a `File matches the working tree` message
- Compares the current file with the working tree — if the current file *is* the working file, it will show a `File matches the working tree` message
- Changes the behavior of the *Compare File with Previous* command (`gitlens.diffWithPrevious`) - always does what it says :)
- Compares the current file with the previous commit to that file
- Changes the behavior of the `gitlens.diffWithPrevious` status bar command option - compares the current line commit with the previous
@ -871,15 +871,15 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Caches many more git commands to reduce git command round-trips and parsing
- Increases the debounce (delay) on cursor movement to reduce lag when navigating around a file
- Adds diff information (the line's previous version) into the active line hover when the current line is uncommitted
- Adds `gitlens.statusBar.alignment` settings to control the alignment of the status bar -- thanks to [PR #72](https://github.com/eamodio/vscode-gitlens/pull/72) by Zack Schuster ([@zackschuster](https://github.com/zackschuster))!
- Adds `gitlens.statusBar.alignment` settings to control the alignment of the status bar — thanks to [PR #72](https://github.com/eamodio/vscode-gitlens/pull/72) by Zack Schuster ([@zackschuster](https://github.com/zackschuster))!
- Adds *Open Branch in Remote* command (`gitlens.openBranchInRemote`) - opens the current branch commits in the supported remote service
- Adds *Open Repository in Remote* command (`gitlens.openRepoInRemote`) - opens the repository in the supported remote service
- Adds *Stash Changes* option to stashed changes quick pick menu -- no longer hidden behind the `"gitlens.insiders": true` setting
- Adds *Stash Unstaged Changes* option to stashed changes quick pick menu -- no longer hidden behind the `"gitlens.insiders": true` setting
- Adds *Apply Stashed Changes* command (`gitlens.stashApply`) to apply the selected stashed changes to the working tree -- no longer hidden behind the `"gitlens.insiders": true` setting
- Adds *Stash Changes* command (`gitlens.stashSave`) to stash any working tree changes -- no longer hidden behind the `"gitlens.insiders": true` setting
- Adds *Stash Changes* option to stashed changes quick pick menu — no longer hidden behind the `"gitlens.insiders": true` setting
- Adds *Stash Unstaged Changes* option to stashed changes quick pick menu — no longer hidden behind the `"gitlens.insiders": true` setting
- Adds *Apply Stashed Changes* command (`gitlens.stashApply`) to apply the selected stashed changes to the working tree — no longer hidden behind the `"gitlens.insiders": true` setting
- Adds *Stash Changes* command (`gitlens.stashSave`) to stash any working tree changes — no longer hidden behind the `"gitlens.insiders": true` setting
- Adds support to the *Search commits* command (`gitlens.showCommitSearch`) to work without any active editor
- Adds commit search pre-population -- if there is an active editor it will use the commit sha of the current line commit, otherwise it will use the current clipboard
- Adds commit search pre-population — if there is an active editor it will use the commit sha of the current line commit, otherwise it will use the current clipboard
### Changed
- Changes *Open File in Remote* and *Open Line Commit in Remote* commands to actually work for everyone (part of their implementation was still behind the `gitlens.insiders` setting)
@ -927,7 +927,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [3.4.5] - 2017-04-13
### Added
- Completely overhauls the [GitLens documentation](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens) and messaging -- make sure to check it out to see all the powerful features GitLen provides!
- Completely overhauls the [GitLens documentation](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens) and messaging — make sure to check it out to see all the powerful features GitLen provides!
- Adds `gitlens.blame.annotation.activeLineDarkColor`&`gitlens.blame.annotation.activeLineLightColor` settings to control the colors of the active line blame annotation
### Changed
@ -955,7 +955,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [3.3.1] - 2017-04-09
### Changed
- Changes commit search prefixes -- no prefix for message search, `@` for author, `:` for file pattern, `#` for commit id
- Changes commit search prefixes — no prefix for message search, `@` for author, `:` for file pattern, `#` for commit id
- Changes `sha` terminology to `commit id` in the UI
### Fixed
@ -982,7 +982,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [3.2.0]
### Added
- Adds support for single files opened in vscode -- you are no longer required to open a folder for GitLens to work
- Adds support for single files opened in vscode — you are no longer required to open a folder for GitLens to work
### Fixed
- Fixes [#57](https://github.com/eamodio/vscode-gitlens/issues/57) - Warn on directory compare when there is no diff tool configured
@ -992,7 +992,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [3.1.0]
### Added
- Adds *Show Stashed Changes* command (`gitlens.showQuickStashList`) to open a quick pick menu of all the stashed changes
- Adds insiders *Stash Changes* option to stashed changes quick pick menu -- enabled via `"gitlens.insiders": true`
- Adds insiders *Stash Changes* option to stashed changes quick pick menu — enabled via `"gitlens.insiders": true`
- Adds insiders *Stash Unstaged Changes* option to stashed changes quick pick menu
- Adds insiders *Apply Stashed Changes* command (`gitlens.stashApply`) to apply the selected stashed changes to the working tree
- Adds insiders *Stash Changes* command (`gitlens.stashSave`) to stash any working tree changes
@ -1002,7 +1002,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [3.0.5]
### Added
- Adds additional insiders support for GitLab, Bitbucket, and Visual Studio Team Services to the *Open x in Remote* commands and quick pick menus -- enabled via `"gitlens.insiders": true`
- Adds additional insiders support for GitLab, Bitbucket, and Visual Studio Team Services to the *Open x in Remote* commands and quick pick menus — enabled via `"gitlens.insiders": true`
- Adds insiders line support to *Open File in Remote* command (`gitlens.openFileInRemote`)
- Adds original file name for renamed files to the repository status and commit details quick pick menu
@ -1018,7 +1018,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [3.0.3]
### Added
- Adds a fallback to work with Git version prior to `2.11.0`-- terribly sorry for the inconvenience :(
- Adds a fallback to work with Git version prior to `2.11.0`— terribly sorry for the inconvenience :(
### Fixed
- Fixes [#55](https://github.com/eamodio/vscode-gitlens/issues/55) - reverts Git requirement back to `2.2.0`
@ -1030,11 +1030,11 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Adds insiders support for *Open in GitHub* to the relevant quick pick menus -- enabled via `"gitlens.insiders": true`
- Adds insiders support for *Open in GitHub* to the relevant quick pick menus — enabled via `"gitlens.insiders": true`
- Adds insiders *Open Line Commit in Remote* command (`gitlens.openCommitInRemote`) to open the current commit in the remote service (currently only GitHub)
- Adds insiders *Open File in Remote* command (`gitlens.openFileInRemote`) to open the current file in the remote service (currently only GitHub)
- Adds an update notification for feature releases
@ -1146,7 +1146,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
### Fixed
- Fixes [#43](https://github.com/eamodio/vscode-gitlens/issues/43) - File-level code lens isn't using the blame of the whole file as it should
- Fixes issue with single quotes (') in annotations
- Fixes output channel logging (also adds more debug information to code lens -- when enabled)
- Fixes output channel logging (also adds more debug information to code lens — when enabled)
## [2.10.0]
### Added
@ -1258,7 +1258,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Changes *Not Committed Yet* author for uncommitted changes to *Uncommitted*
### Fixed
- Fixes showing `gitlens.showQuickCommitDetails` quick pick menu for uncommitted changes -- now shows the previous commit details
- Fixes showing `gitlens.showQuickCommitDetails` quick pick menu for uncommitted changes — now shows the previous commit details
## [2.5.1]
### Added
@ -1344,14 +1344,14 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
### Added
- Adds `gitlens.blame.annotation.activeLine` to specify whether and how to show blame annotations on the active line
- Adds full commit message (rather than just summary) to active line hover if `gitlens.blame.annotation.activeLine` is not `off`
- Adds new `trailing` blame annotation style -- adds annotations after the code lines rather than before
- Adds new `trailing` blame annotation style — adds annotations after the code lines rather than before
- Adds `gitlens.blame.annotation.message` to show the commit message in `expanded` and `trailing` blame annotation styles
- Adds support for relative dates in blame annotations. Use `gitlens.blame.annotation.date`
- Re-adds context menu for `gitlens.diffLineWithPrevious`-- since [vscode issue](https://github.com/Microsoft/vscode/issues/15395)
- Re-adds context menu for `gitlens.diffLineWithWorking`-- since [vscode issue](https://github.com/Microsoft/vscode/issues/15395)
- Re-adds context menu for `gitlens.diffLineWithPrevious`— since [vscode issue](https://github.com/Microsoft/vscode/issues/15395)
- Re-adds context menu for `gitlens.diffLineWithWorking`— since [vscode issue](https://github.com/Microsoft/vscode/issues/15395)
### Changed
- Changes the design of hover annotations -- much cleaner now
- Changes the design of hover annotations — much cleaner now
- Disables automatic whitespace toggling by default as it is seemingly no longer needed as [vscode issue](https://github.com/Microsoft/vscode/issues/11485) seems fixed. It can be re-enabled with `gitlens.advanced.toggleWhitespace.enabled`
### Fixed
@ -1383,9 +1383,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Adds `gitlens.showFileHistory` as `alt` context menu item for `gitlens.showQuickFileHistory`
### Removed
- Removes context menu for `gitlens.diffLineWithPrevious`-- since it is now the `alt` of `gitlens.diffWithPrevious`
- Removes context menu for `gitlens.diffLineWithWorking`-- since it is now the `alt` of `gitlens.diffWithWorking`
- Replaces `gitlens.menus.fileDiff.enabled` and `gitlens.menus.lineDiff.enabled` with `gitlens.menus.diff.enabled`-- since the switch between file and line diff is now controlled by the `alt` key
- Removes context menu for `gitlens.diffLineWithPrevious`— since it is now the `alt` of `gitlens.diffWithPrevious`
- Removes context menu for `gitlens.diffLineWithWorking`— since it is now the `alt` of `gitlens.diffWithWorking`
- Replaces `gitlens.menus.fileDiff.enabled` and `gitlens.menus.lineDiff.enabled` with `gitlens.menus.diff.enabled`— since the switch between file and line diff is now controlled by the `alt` key
## [1.3.1]
### Added
@ -1399,7 +1399,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [1.3.0]
### Added
- Adds support for blame and history (log) on files opened via compare commands -- allows for deep navigation through git history
- Adds support for blame and history (log) on files opened via compare commands — allows for deep navigation through git history
## [1.2.0]
### Added
@ -1478,7 +1478,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [0.5.1]
### Added
- Adds blame information in the status bar
- Add new status bar settings -- see **Extension Settings** for details
- Add new status bar settings — see **Extension Settings** for details
- Adds new `gitlens.diffWithPrevious` option to the `gitlens.codeLens.recentChange.command`&`gitlens.codeLens.authors.command` settings
### Changed
@ -1500,7 +1500,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [0.3.1]
### Added
- Adds new code lens visibility & location settings -- see **Extension Settings** for details
- Adds new code lens visibility & location settings — see **Extension Settings** for details
- Adds new command to toggle code lens on and off when `gitlens.codeLens.visibility` is set to `ondemand`
## [0.2.0]
@ -1516,7 +1516,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
## [0.1.3]
### Added
- Improved blame annotations, now with sha and author by default
- Add new blame annotation styles -- compact and expanded (default)
- Add new blame annotation styles — compact and expanded (default)
- Adds many new configuration settings; see **Extension Settings** for details
> GitLens **supercharges** the Git capabilities built into Visual Studio Code. It helps you to **visualize code authorship** at a glance via Git blame annotations and code lens, **seamlessly navigate and explore** Git repositories, **gain valuable insights** via powerful comparison commands, and so much more.
@ -21,18 +21,21 @@ GitLens simply helps you understand code better. Quickly glimpse into who, why,
Here are just some of the features that GitLens provides,
- a [*GitLens* explorer](#gitlens-explorer "Jump to the GitLens explorer") to navigate and explore repositories or file histories
- an on-demand [*GitLens Results* view](#gitlens-results-view "Jump to the GitLens Results view") to explore commit searches, visualize comparisions between branches, tags, commits, and more
- Git authorship [code lens](#code-lens "Jump to the Code Lens") showing the most recent commit and # of authors to the top of files and/or on code blocks
- an unobtrusive Git blame annotation to the end of the [current line](#current-line-blame "Jump to the Current Line Blame")
- on-demand [Git blame annotations](#gutter-blame "Jump to the Gutter Blame"), including a heatmap, to the gutter for the whole file
- detailed Git blame information accessible via [hovers](#hovers "Jump to the Hovers")
- a status bar Git blame annotation showing author and date, by default, about the current line
- many powerful commands for exploring commits and histories, comparing and navigating revisions, stash access, repository status, and more
GitLens is powerful, feature rich, and also [highly customizable](#gitlens-settings "Jump to the GitLens settings docs") to meet your specific needs — find code lens intrusive or the current line blame annotation distracting — no problem, it is quick and easy to turn them off or change how they behave via the built-in *GitLens Settings* editor, a WYSIWYG editor covering many of GitLens' powerful settings. While for more advanced customizations, refer to the [GitLens settings docs](#gitlens-settings "Jump to the GitLens settings docs") and edit your vscode [user settings](https://code.visualstudio.com/docs/getstarted/settings).
- authorship [code lens](#code-lens "Jump to the Code Lens") showing the most recent commit and # of authors to the top of files and/or on code blocks
- an unobtrusive [current line blame](#current-line-blame "Jump to the Current Line Blame") annotation at the end of the line
- on-demand [gutter blame](#gutter-blame "Jump to the Gutter Blame") annotations, including a heatmap, for the whole file
- detailed blame information accessible via [hovers](#hovers "Jump to the Hovers")
- on-demand [recent changes](#recent-changes "Jump to the Recent Changes") annotations to highlight lines changed by the most recent commit
- a [status bar blame](#status-bar-blame "Jump to the Status Bar Blame") annotation showing author and date for the current line
- [commit search](#commit-search "Jump to the Commit Search") — by message, author, filename, commit id, or code changes
- many powerful commands for exploring commits and histories, comparing and navigating revisions, stash access, repository status, etc
- and so much more
GitLens is powerful, feature rich, and also [highly customizable](#gitlens-settings "Jump to the GitLens settings docs") to meet your specific needs — find code lens intrusive or the current line blame annotation distracting — no problem, it is quick and easy to turn them off or change how they behave via the built-in *GitLens Settings* editor, a WYSIWYG editor covering many of GitLens' powerful settings. While for more advanced customizations, refer to the [GitLens settings docs](#gitlens-settings "Jump to the GitLens settings docs") and edit your vscode [user settings](https://code.visualstudio.com/docs/getstarted/settings "Open User settings").
@ -46,7 +49,7 @@ A [customizable](#gitlens-explorer-settings "Jump to the GitLens Explorer settin
#### Repository view
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/feature-settings/images/screenshot-gitlens-explorer-repository.png"alt="GitLens Explorer Repository view">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-gitlens-explorer-repository.png"alt="GitLens Explorer Repository view"/>
</p>
The repository view provides a full Git repository explorer, which has the following features,
@ -109,7 +112,7 @@ The repository view provides a full Git repository explorer, which has the follo
### History view
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/feature-settings/images/screenshot-gitlens-explorer-history.png"alt="GitLens Explorer History view">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-gitlens-explorer-history.png"alt="GitLens Explorer History view"/>
</p>
The history view provides the revision history of the active file, which has the following features,
@ -118,9 +121,10 @@ The history view provides the revision history of the active file, which has the
- Context menus for each revision (commit) provides
- *Open Changes*, *Open Changes with Working File*, *Open File*, *Open Revision*, *Open File in Remote* (if available), *Open Revision in Remote* (if available), *Apply Changes*, and *Show Commit File Details* commands
An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens Results view settings") view to explore commits, histories, and searches, or visualize comparisions between branches, tags, commits, and more
@ -158,20 +162,21 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- Context menus for each changed file provide
- *Open Changes*, *Open Changes with Working File*, *Open File*, *Open Revision*, *Open File in Remote*, *Open Revision in Remote*, *Apply Changes*, and *Show Commit File Details* commands
- Adds Git authorship **code lens** to the top of the file and on code blocks ([optional](#code-lens-settings "Jump to the Code Lens settings"), on by default)
- **Recent Change**— author and date of the most recent commit for the file or code block
- Clicking the code lens will, by [default](#code-lens-settings "Jump to the Code Lens settings"), show a **commit file details quick pick menu** with commands for comparing, navigating and exploring commits, and more
- Click the code lens to show a **commit file details quick pick menu** with commands for comparing, navigating and exploring commits, and more (by [default](#code-lens-settings "Jump to the Code Lens settings"))
- **Authors**— number of authors of the file or code block and the most prominent author (if there is more than one)
- Clicking the code lens will, by [default](#code-lens-settings "Jump to the Code Lens settings"), toggle the file Git blame annotations on and off of the whole file
- Click the code lens to toggle the file Git blame annotations on and off of the whole file (by [default](#code-lens-settings "Jump to the Code Lens settings"))
- Will be hidden if the author of the most recent commit is also the only author of the file or block, to avoid duplicate information and reduce visual noise
- Provides [customizable](#code-lens-settings "Jump to the Code Lens settings") click behavior for each code lens — choose between one of the following
- Provides [customizable](#code-lens-settings "Jump to the Code Lens settings") click behavior for each code lens — choose between one of the following
- Toggle file blame annotations on and off
- Compare the commit with the previous commit
- Show a quick pick menu with details and commands for the commit
@ -181,100 +186,116 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- Adds a *Toggle Git Code Lens* command (`gitlens.toggleCodeLens`) with a shortcut of `shift+alt+b` to toggle the code lens on and off
---
### Current Line Blame
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/feature-settings/images/screenshot-current-line-blame.png"alt="Current Line Blame">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-current-line-blame.png"alt="Current Line Blame"/>
</p>
- Adds an unobtrusive, [customizable](#current-line-blame-settings "Jump to the Current Line Blame settings"), and [themable](#themable-colors "Jump to the Themable Colors"), **Git blame annotation** to the end of the current line
- Contains the author, date, and message of the current line's most recent commit, by [default](#current-line-blame-settings "Jump to the Current Line Blame settings")
- Adds an unobtrusive, [customizable](#current-line-blame-settings "Jump to the Current Line Blame settings"), and [themable](#themable-colors "Jump to the Themable Colors"), **blame annotation** at the end of the current line
- Contains the author, date, and message of the current line's most recent commit (by [default](#current-line-blame-settings "Jump to the Current Line Blame settings"))
- Adds a *Show Line Blame Annotations* command (`gitlens.showLineBlame`)
- Adds a *Toggle Line Blame Annotations* command (`gitlens.toggleLineBlame`) to toggle the blame annotation on and off
- Adds an on-demand, [customizable](#gutter-blame-settings "Jump to the Gutter Blame settings"), and [themable](#themable-colors "Jump to the Themable Colors"), **Git blame annotations** to the gutter of the whole file
- Adds on-demand, [customizable](#gutter-blame-settings "Jump to the Gutter Blame settings"), and [themable](#themable-colors "Jump to the Themable Colors"), **gutter blame annotations** for the whole file
- Contains the commit message and date, by [default](#gutter-blame-settings "Jump to the Gutter Blame settings")
- Adds a **heatmap** (age) indicator on right edge (by [default](#gutter-blame-settings "Jump to the Gutter Blame settings")) of the gutter to provide an easy, at-a-glance way to tell the age of a line ([optional](#gutter-blame-settings "Jump to the Gutter Blame settings"), on by default)
- Indicator ranges from bright yellow (newer) to dark brown (older)
- Adds a *Show File Blame Annotations* command (`gitlens.showFileBlame`)
- Adds a *Toggle File Blame Annotations* command (`gitlens.toggleFileBlame`) with a shortcut of `alt+b` to toggle the blame annotations on and off
- Press `Escape` to turn off the annotations
### Hovers
- Adds [customizable](#hover-settings "Jump to the Hover settings") detailed Git blame information accessible via hovers
- Adds an on-demand **heatmap** to the edge of the gutter to show the relative age of a line
- Indicator ranges from bright yellow (newer) to dark brown (older)
- Adds *Toggle File Heatmap Annotations* command (`gitlens.toggleFileHeatmap`) to toggle the heatmap on and off
- Press `Escape` to turn off the annotations
---
### Hovers
#### Current Line Hovers
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-hovers-current-line.png"alt="Current Line Hovers"/>
</p>
- Adds [customizable](#hover-settings "Jump to the Hover settings") Git blame hovers accessible over the current line
##### Details Hover
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-hovers-current-line-details.png"alt="Current Line Details Hover"/>
</p>
### Git Blame Annotations
- Adds a **details hover** annotation to the current line to show more commit details ([optional](#hover-settings "Jump to the Hover settings"), on by default)
- Provides a **quick-access command bar** with *Open Changes*, *Blame Previous Revision*, *Open in Remote*, and *Show More Actions* command buttons
- Click the commit id to execute the *Show Commit Details* command (`gitlens.showQuickCommitDetails`)
- Adds an unobtrusive, highly [customizable](#line-blame-annotation-settings) and [themable](#themable-colors), **Git blame annotation** to the end of the current line ([optional](#line-blame-annotation-settings), on by default)
##### Changes (diff) Hover
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-hovers-current-line-changes.png"alt="Current Line Changes (diff) Hover"/>
- Contains the author, date, and message of the line's most recent commit, by [default](#line-blame-annotation-settings)
- Adds a **details** hover annotation to the current line annotation, which provides more commit details ([optional](#line-blame-annotation-settings), on by default)
- Adds a **changes (diff) hover** annotation to the current line to show the line's previous version ([optional](#hover-settings "Jump to the Hover settings"), on by default)
- Click the **Changes** to execute the *Compare File Revisions* command (`gitlens.diffWith`)
- Click the current and previous commit ids to execute the *Show Commit Details* command (`gitlens.showQuickCommitDetails`)
- Provides a **quick-access command bar** with *Open Changes*, *Blame Previous Revision*, *Open in Remote*, and *Show More Actions* command buttons
- Clicking the commit id will run the *Show Commit Details* command (`gitlens.showQuickCommitDetails`)
- Adds [customizable](#hover-settings "Jump to the Hover settings") Git blame hovers accessible when annotating
- Adds a **changes** (diff) hover annotation to the current line annotation, which provides **instant access** to the line's previous version ([optional](#line-blame-annotation-settings), on by default)
- Adds a **details hover** annotation to each line while annotating to show more commit details ([optional](#hover-settings "Jump to the Hover settings"), on by default)
- Provides a **quick-access command bar** with *Open Changes*, *Blame Previous Revision*, *Open in Remote*, and *Show More Actions* command buttons
- Click the commit id to execute the *Show Commit Details* command (`gitlens.showQuickCommitDetails`)
- Clicking on **Changes** will run the *Compare File Revisions* command (`gitlens.diffWith`)
- Clicking the current and previous commit ids will run the *Show Commit Details* command (`gitlens.showQuickCommitDetails`)
- Adds on-demand, beautiful, highly [customizable](#file-blame-annotation-settings) and [themable](#themable-colors), **Git blame annotations** of the whole file
- Adds a **changes (diff) hover** annotation to each line while annotating to show the line's previous version ([optional](#hover-settings "Jump to the Hover settings"), on by default)
- Click the **Changes** to execute the *Compare File Revisions* command (`gitlens.diffWith`)
- Click the current and previous commit ids to execute the *Show Commit Details* command (`gitlens.showQuickCommitDetails`)
- Choose between *gutter* (default) and *hover* [annotation styles](#file-blame-annotation-settings)
- Contains the commit message and date, by [default](#file-blame-annotation-settings)
- Adds a **details** hover annotation to the line's annotation, which provides more commit details ([optional](#file-blame-annotation-settings), on by default)
- Adds an on-demand, [customizable](#recent-changes-settings "Jump to the Recent Changes settings") and [themable](#themable-colors "Jump to the Themable Colors"), **recent changes annotation** to highlight lines changed by the most recent commit
- Adds *Toggle Recent File Changes Annotations* command (`gitlens.toggleFileRecentChanges`) to toggle the recent changes annotations on and off
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-status-bar.png"alt="Status Bar Blame"/>
</p>
- Provides a **quick-access command bar** with *Open Changes*, *Blame Previous Revision*, *Open in Remote*, and *Show More Actions* command buttons
- Clicking the commit id will run the *Show Commit Details* command (`gitlens.showQuickCommitDetails`)
- Adds a **changes**` (diff) hover annotation to the line's annotation, which provides **instant access** to the line's previous version ([optional](#file-blame-annotation-settings), on by default)
- Clicking on **Changes** will run the *Compare File Revisions* command (`gitlens.diffWith`)
- Clicking the current and previous commit ids will run the *Show Commit Details* command (`gitlens.showQuickCommitDetails`)
- Adds a **heatmap** (age) indicator to the gutter annotations (on right edge by [default](#file-blame-annotation-settings)), which provides an easy, at-a-glance way to tell the age of a line ([optional](#file-blame-annotation-settings), on by default)
- Indicator ranges from bright yellow (newer) to dark brown (older)
- Press `Escape` to quickly toggle the annotations off
- Adds a [customizable](#status-bar-settings "Jump to the Status Bar Blame settings") **Git blame annotation** about the current line to the **status bar** ([optional](#status-bar-settings "Jump to the Status Bar Blame settings"), on by default)
- Adds [customizable](#status-bar-settings) **blame information** about the current line to the **status bar** ([optional](#status-bar-settings), on by default)
- Contains the commit author and date (by [default](#status-bar-settings "Jump to the Status Bar Blame settings"))
- Click the status bar item to show a **commit details quick pick menu** with commands for comparing, navigating and exploring commits, and more (by [default](#status-bar-settings "Jump to the Status Bar Blame settings"))
- Contains the commit author and date, by [default](#status-bar-settings)
- Clicking the status bar item will, by [default](#status-bar-settings), show a **commit details quick pick menu** with commands for comparing, navigating and exploring commits, and more
- Provides [customizable](#status-bar-settings) click behavior — choose between one of the following
- Provides [customizable](#status-bar-settings "Jump to the Status Bar Blame settings") click behavior — choose between one of the following
- Toggle file blame annotations on and off
- Toggle code lens on and off
- Compare the line commit with the previous commit
@ -284,121 +305,115 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- Show a quick pick menu with the commit history of the file
- Show a quick pick menu with the commit history of the current branch
- Adds a *Toggle File Blame Annotations* command (`gitlens.toggleFileBlame`) with a shortcut of `alt+b` to toggle the file blame annotations on and off
- Also adds a *Show File Blame Annotations* command (`gitlens.showFileBlame`)
- Adds a *Toggle Line Blame Annotations* command (`gitlens.toggleLineBlame`) to toggle the current line blame annotations on and off
- Also adds a *Show Line Blame Annotations* command (`gitlens.showLineBlame`)
### Git Heatmap Annotations
- Adds on-demand **heatmap annotations** of the whole file
- Displays a **heatmap** (age) indicator near the gutter, which provides an easy, at-a-glance way to tell the age of a line
- Indicator ranges from bright yellow (newer) to dark brown (older)
- Press `Escape` to quickly toggle the annotations off
- Adds *Toggle File Heatmap Annotations* command (`gitlens.toggleFileHeatmap`) to toggle the heatmap annotations on and off
### Git Recent Changes Annotations
- Adds on-demand, [customizable](#file-recent-changes-annotation-settings) and [themable](#themable-colors), **recent changes annotations** of the whole file
- Highlights all of lines changed in the most recent commit
- Adds a **details** hover annotation to each line, which provides more commit details ([optional](#file-recent-changes-annotation-settings), on by default)
- Clicking the commit id will run the *Show Commit Details* command (`gitlens.showQuickCommitDetails`)
- Adds a **changes** (diff) hover annotation to each line, which provides **instant** access to the line's previous version ([optional](#file-recent-changes-annotation-settings), on by default)
- Clicking on **Changes** will run the *Compare File Revisions* command (`gitlens.diffWith`)
- Clicking the current and previous commit ids will run the *Show Commit Details* command (`gitlens.showQuickCommitDetails`)
- Press `Escape` to quickly toggle the annotations off
- Adds *Toggle Recent File Changes Annotations* command (`gitlens.toggleFileRecentChanges`) to toggle the recent changes annotations on and off
### Navigate and Explore
---
### Commit Search
- Adds a *Search Commits* command (`gitlens.showCommitSearch`) with a shortcut of `alt+/` to search for commits by message, author, file(s), commit id, or code changes
- Use `<message>` to search for commits with messages that match `<message>`-- See [Git docs](https://git-scm.com/docs/git-log#git-log---grepltpatterngt)
- Use `@<pattern>` to search for commits with authors that match `<pattern>`-- See [Git docs](https://git-scm.com/docs/git-log#git-log---authorltpatterngt)
- Use `:<pattern>` to search for commits with file names that match `<pattern>`-- See [Git docs](https://git-scm.com/docs/git-log)
- Use `#<sha>` to search for a commit with id of `<sha>`-- See [Git docs](https://git-scm.com/docs/git-log)
- Use `~<pattern>` to search for commits with differences whose patch text contains added/removed lines that match `<pattern>`-- See [Git docs](https://git-scm.com/docs/git-log#git-log--Gltregexgt)
- Use `=<string>` to search for commits with differences that change the number of occurrences of the specified string (i.e. addition/deletion) in a file -- See [Git docs](https://git-scm.com/docs/git-log#git-log--Sltstringgt)
- Use `<message>` to search for commits with messages that match `<message>`— See [Git docs](https://git-scm.com/docs/git-log#git-log---grepltpatterngt "Open Git docs")
- Use `@<pattern>` to search for commits with authors that match `<pattern>`— See [Git docs](https://git-scm.com/docs/git-log#git-log---authorltpatterngt "Open Git docs")
- Use `:<pattern>` to search for commits with file names that match `<pattern>`— See [Git docs](https://git-scm.com/docs/git-log "Open Git docs")
- Use `#<sha>` to search for a commit with id of `<sha>`— See [Git docs](https://git-scm.com/docs/git-log "Open Git docs")
- Use `~<pattern>` to search for commits with differences whose patch text contains added/removed lines that match `<pattern>`— See [Git docs](https://git-scm.com/docs/git-log#git-log--Gltregexgt "Open Git docs")
- Use `=<string>` to search for commits with differences that change the number of occurrences of the specified string (i.e. addition/deletion) in a file — See [Git docs](https://git-scm.com/docs/git-log#git-log--Sltstringgt "Open Git docs")
- Provides a *Show in Results* option to show the search results in the **GitLens Results** view
- Adds commands to open files, commits, branches, and the repository in the supported remote services, **BitBucket, GitHub, GitLab, and Visual Studio Team Services** or a [**user-defined** remote services](#custom-remotes-settings) — only available if a Git upstream service is configured in the repository
- Also supports [remote services with custom domains](#custom-remotes-settings), such as **BitBucket, Bitbucket Server (previously called Stash), GitHub, GitHub Enterprise, GitLab**
- *Open Branches in Remote* command (`gitlens.openBranchesInRemote`) — opens the branches in the supported remote service
- *Open Branch in Remote* command (`gitlens.openBranchInRemote`) — opens the current branch commits in the supported remote service
- *Open Commit in Remote* command (`gitlens.openCommitInRemote`) — opens the commit revision of the active line in the supported remote service
- *Open File in Remote* command (`gitlens.openFileInRemote`) — opens the active file/revision in the supported remote service
- *Open Repository in Remote* command (`gitlens.openRepoInRemote`) — opens the repository in the supported remote service
---
### Navigate and Explore
- Adds a *Show Current Branch History* command (`gitlens.showQuickRepoHistory`) with a shortcut of `shift+alt+h` to show a paged **branch history quick pick menu** of the current branch for exploring its commit history
- Adds a *Show Last Opened Quick Pick* command (`gitlens.showLastQuickPick`) with a shortcut of `alt+-` to quickly get back to where you were when the last GitLens quick pick menu closed
- Adds commands to open files, commits, branches, and the repository in the supported remote services, **BitBucket, GitHub, GitLab, and Visual Studio Team Services** or a [**user-defined** remote services](#custom-remotes-settings "Jump to Custom Remotes settings") — only available if a Git upstream service is configured in the repository
- Also supports [remote services with custom domains](#custom-remotes-settings "Jump to Custom Remotes settings"), such as **BitBucket, Bitbucket Server (previously called Stash), GitHub, GitHub Enterprise, GitLab**
- *Open Branches in Remote* command (`gitlens.openBranchesInRemote`) — opens the branches in the supported remote service
- *Open Branch in Remote* command (`gitlens.openBranchInRemote`) — opens the current branch commits in the supported remote service
- *Open Commit in Remote* command (`gitlens.openCommitInRemote`) — opens the commit revision of the active line in the supported remote service
- *Open File in Remote* command (`gitlens.openFileInRemote`) — opens the active file/revision in the supported remote service
- *Open Repository in Remote* command (`gitlens.openRepoInRemote`) — opens the repository in the supported remote service
- Provides entries to *Show Commit Search* and *Open Branch in <remote-service>* when available
#### Branch History
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-menu-branch-history.png"alt="Branch History Quick Pick Menu"/>
</p>
- Adds a *Show Current Branch History* command (`gitlens.showQuickRepoHistory`) with a shortcut of `shift+alt+h` to show a paged **branch history quick pick menu** of the current branch for exploring its commit history
- Provides entries to *Show Commit Search* and *Open Branch in \<remote-service\>* when available
- Navigate back to the previous quick pick menu via `alt+left arrow`, if available
- Navigate pages via `alt+,` and `alt+.` to go backward and forward respectively
- Adds a *Show Branch History* command (`gitlens.showQuickBranchHistory`) to show a paged **branch history quick pick menu** of the selected branch for exploring its commit history
- Provides the same features as *Show Current Branch History* above
- Adds a *Show File History* command (`gitlens.showQuickFileHistory`) to show a paged **file history quick pick menu** of the active file for exploring its commit history
#### File History
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-menu-file-history.png"alt="File History Quick Pick Menu"/>
</p>
- Provides additional entries to *Show in Results*, *Show Branch History*, and *Open File in <remote-service>* when available
- Adds a *Show File History* command (`gitlens.showQuickFileHistory`) to show a paged **file history quick pick menu** of the active file for exploring its commit history
- Provides additional entries to *Show in Results*, *Show Branch History*, and *Open File in \<remote-service\>* when available
- Navigate back to the previous quick pick menu via `alt+left arrow`, if available
- Navigate pages via `alt+,` and `alt+.` to go backward and forward respectively
- Adds a *Show Commit Details* command (`gitlens.showQuickCommitDetails`) to show a **commit details quick pick menu** of the most recent commit of the active file
- Adds a *Show Commit Details* command (`gitlens.showQuickCommitDetails`) to show a **commit details quick pick menu** of the most recent commit of the active file
- Quickly see the set of files changed in the commit, complete with status indicators for adds, changes, renames, and deletes
- Provides additional entries to *Show in Results*, *Open Commit in <remote-service>* when available, *Open Files*, *Open Revisions*, *Open Directory Compare with Previous Revision*, *Open Directory Compare with Working Tree*, *Copy Commit ID to Clipboard*, *Copy Commit Message to Clipboard*
- Provides additional entries to *Show in Results*, *Open Commit in \<remote-service\>* when available, *Open Files*, *Open Revisions*, *Open Directory Compare with Previous Revision*, *Open Directory Compare with Working Tree*, *Copy Commit ID to Clipboard*, *Copy Commit Message to Clipboard*
- Navigate back to the previous quick pick menu via `alt+left arrow`, if available
- Use the `alt+right arrow` shortcut on an entry to execute it without closing the quick pick menu, if possible — commands that open windows outside of VS Code will still close the quick pick menu unless [`"gitlens.advanced.quickPick.closeOnFocusOut": false`](#advanced-settings) is set
- Use the `alt+right arrow` shortcut on an entry to execute it without closing the quick pick menu, if possible — commands that open windows outside of VS Code will still close the quick pick menu unless [`"gitlens.advanced.quickPick.closeOnFocusOut": false`](#advanced-settings "Jump to Advanced settings") is set
- Use the `alt+right arrow` shortcut on a file entry in the `Changed Files` section to preview the comparison of the current revision with the previous one
- Adds a *Show Commit File Details* command (`gitlens.showQuickCommitFileDetails`) with a shortcut of `alt+c` to show a **file commit details quick pick menu** of the most recent commit of the active file
- Provides entries to *Open Changes*, *Open Changes with Working File*, *Open File*, *Open Revision*, *Open File in <remote-service>* when available, *Open Revision in <remote-service>* when available, *Copy Commit ID to Clipboard*, *Copy Commit Message to Clipboard*, *Show Commit Details*, *Show File History*, and *Show Previous File History*
- Adds a *Show Commit File Details* command (`gitlens.showQuickCommitFileDetails`) with a shortcut of `alt+c` to show a **file commit details quick pick menu** of the most recent commit of the active file
- Provides entries to *Open Changes*, *Open Changes with Working File*, *Open File*, *Open Revision*, *Open File in \<remote-service\>* when available, *Open Revision in \<remote-service\>* when available, *Copy Commit ID to Clipboard*, *Copy Commit Message to Clipboard*, *Show Commit Details*, *Show File History*, and *Show Previous File History*
- Navigate back to the previous quick pick menu via `alt+left arrow`, if available
- Use the `alt+right arrow` shortcut on an entry to execute it without closing the quick pick menu, if possible — commands that open windows outside of VS Code will still close the quick pick menu unless [`"gitlens.advanced.quickPick.closeOnFocusOut": false`](#advanced-settings) is set
- Use the `alt+right arrow` shortcut on an entry to execute it without closing the quick pick menu, if possible — commands that open windows outside of VS Code will still close the quick pick menu unless [`"gitlens.advanced.quickPick.closeOnFocusOut": false`](#advanced-settings "Jump to Advanced settings") is set
- Adds a *Show Repository Status* command (`gitlens.showQuickRepoStatus`) with a shortcut of `alt+s` to show a **repository status quick pick menu** for visualizing the current repository status
#### Repository Status
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-menu-repo-status.png"alt="Repository Status Quick Pick Menu"/>
</p>
- Quickly see upstream status (if an Git upstream is configured) — complete with ahead and behind information
- Adds a *Show Repository Status* command (`gitlens.showQuickRepoStatus`) with a shortcut of `alt+s` to show a **repository status quick pick menu** for visualizing the current repository status
- Quickly see upstream status (if an Git upstream is configured) — complete with ahead and behind information
- If you are ahead of the upstream, an entry will be shown with the number of commits ahead. Choosing it will show a limited **branch history quick pick menu** containing just the commits ahead of the upstream
- If you are behind the upstream, an entry will be shown with the number of commits behind. Choosing it will show a limited **branch history quick pick menu** containing just the commits behind the upstream
- Quickly see all working changes, both staged and unstaged, complete with status indicators for adds, changes, renames, and deletes
- Provides entries to *Show Stashed Changes*, *Open Changed Files*, and *Close Unchanged Files*
- Use the `alt+right arrow` shortcut on an entry to execute it without closing the quick pick menu, if possible — commands that open windows outside of VS Code will still close the quick pick menu unless [`"gitlens.advanced.quickPick.closeOnFocusOut": false`](#advanced-settings) is set
- Use the `alt+right arrow` shortcut on an entry to execute it without closing the quick pick menu, if possible — commands that open windows outside of VS Code will still close the quick pick menu unless [`"gitlens.advanced.quickPick.closeOnFocusOut": false`](#advanced-settings "Jump to Advanced settings") is set
- Use the `alt+right arrow` shortcut on a file entry in the `Staged Files` or `Unstaged Files` sections to preview the comparison of the working file with the previous revision
- Adds a *Show Stashed Changes* command (`gitlens.showQuickStashList`) to show a **stashed changes quick pick menu** for exploring your repository stash history
- Adds a *Show Stashed Changes* command (`gitlens.showQuickStashList`) to show a **stashed changes quick pick menu** for exploring your repository stash history
- Provides additional entries to *Stash Changes*
- Navigate back to the previous quick pick menu via `alt+left arrow`, if available
- Choosing a stash entry shows a **stash details quick pick menu** which is very similar to the **commit details quick pick menu** above
- Adds a *Stash Changes* command (`gitlens.stashSave`) to save any working tree changes to the stash — can optionally provide a stash message
- Also adds the command to the Source Control items context menu to stash an individual or group of files, works with multi-select too!
- Stashed changes show a **stash details quick pick menu** which is very similar to the **commit details quick pick menu** above
- Quickly see the set of files changed in the stash, complete with status indicators for adds, changes, renames, and deletes
- Provides additional entries to *Apply Stashed Changes* (requires confirmation), *Delete Stashed Changes* (requires confirmation), *Open Files*, *Open Revisions*, *Open Directory Compare with Previous Revision*, *Open Directory Compare with Working Tree*, *Copy Commit Message to Clipboard*
- Navigate back to the previous quick pick menu via `alt+left arrow`, if available
- Use the `alt+right arrow` shortcut on an entry to execute it without closing the quick pick menu, if possible — commands that open windows outside of VS Code will still close the quick pick menu unless [`"gitlens.advanced.quickPick.closeOnFocusOut": false`](#advanced-settings) is set
- Use the `alt+right arrow` shortcut on an entry to execute it without closing the quick pick menu, if possible — commands that open windows outside of VS Code will still close the quick pick menu unless [`"gitlens.advanced.quickPick.closeOnFocusOut": false`](#advanced-settings "Jump to Advanced settings") is set
- Use the `alt+right arrow` shortcut on a file entry in the `Changed Files` section to preview the comparison of the current revision with the previous one
- Adds a *Show Last Opened Quick Pick* command (`gitlens.showLastQuickPick`) with a shortcut of `alt+-` to quickly get back to where you were when the last GitLens quick pick menu closed
- Adds a *Apply Stashed Changes* command (`gitlens.stashApply`) to chose a stash entry to apply to the working tree from a quick pick menu
---
### Powerful Comparison Tools
- Effortlessly navigate between comparisons via the `alt+,` and `alt+.` shortcut keys to go back and forth through a file's revisions
@ -421,6 +436,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- Adds a *Compare Line Revision with Working File* command (`gitlens.diffLineWithWorking`) with a shortcut of `alt+w` to compare the commit revision of the active line with the working tree
---
### And More
- Adds a *Copy Commit ID to Clipboard* command (`gitlens.copyShaToClipboard`) to copy the commit id (sha) of the active line to the clipboard or from the most recent commit to the current branch, if there is no active editor
@ -440,29 +456,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- Adds a *Close Unchanged Files* command (`gitlens.closeUnchangedFiles`) to close any files without working tree changes
- Adds a *Apply Stashed Changes* command (`gitlens.stashApply`) to chose a stash entry to apply to the working tree from a quick pick menu
- Adds a *Stash Changes* command (`gitlens.stashSave`) to save any working tree changes to the stash — can optionally provide a stash message
- Also adds the command to the Source Control items context menu to stash an individual or group of files, works with multi-select too!
## Insiders
Add [`"gitlens.insiders": true`](#general-settings) to your settings to join the insiders channel and get early access to upcoming features. Be aware that because this provides early access expect there to be issues.
## Themable Colors
GitLens defines a set of themable colors which can be provided by vscode themes or directly by the user using [`workbench.colorCustomization`](https://code.visualstudio.com/docs/getstarted/themes#_customize-a-color-theme).
|Name | Description
|-----|------------
|`gitlens.gutterBackgroundColor`|Specifies the background color of the gutter blame annotations
|`gitlens.gutterForegroundColor`|Specifies the foreground color of the gutter blame annotations
|`gitlens.gutterUncommittedForegroundColor`|Specifies the foreground color of an uncommitted line in the gutter blame annotations
|`gitlens.trailingLineBackgroundColor`|Specifies the background color of the trailing blame annotation
|`gitlens.trailingLineForegroundColor`|Specifies the foreground color of the trailing blame annotation
|`gitlens.lineHighlightBackgroundColor`|Specifies the background color of the associated line highlights in blame annotations
|`gitlens.lineHighlightOverviewRulerColor`|Specifies the overview ruler color of the associated line highlights in blame annotations
---
## GitLens Settings
GitLens is highly customizable and provides many configuration settings to allow the personalization of almost all features.
@ -474,7 +468,7 @@ GitLens is highly customizable and provides many configuration settings to allow
|`gitlens.defaultDateFormat`|Specifies how absolute dates will be formatted by default<br/>See https://momentjs.com/docs/#/displaying/format/ for valid formats
|`gitlens.defaultDateStyle`|Specifies how dates will be displayed by default
|`gitlens.defaultGravatarsStyle`|Specifies the style of the gravatar default (fallback) images<br/>`identicon` - a geometric pattern<br/>`mm` - (mystery-man) a simple, cartoon-style silhouetted outline of a person (does not vary by email hash)<br/>`monsterid` - a monster with different colors, faces, etc<br/>`retro` - 8-bit arcade-style pixelated faces<br/>`robohash` - a robot with different colors, faces, etc<br/>`wavatar` - faces with differing features and backgrounds
|`gitlens.insiders`|Opts into the insiders channel -- provides access to upcoming features
|`gitlens.insiders`|Opts into the insiders channel — provides access to upcoming features
|`gitlens.keymap`|Specifies the keymap to use for GitLens shortcut keys<br/>`standard` - adds a standard set of shortcut keys<br/>`chorded` - adds a chorded set of shortcut keys that all start with `Ctrl+Shift+G` (`⌥⌘G` on macOS)<br/>`none` - no shortcut keys will be added
|`gitlens.outputLevel`|Specifies how much (if any) output will be sent to the GitLens output channel
@ -550,91 +544,35 @@ See also [Explorer Settings](#explorer-settings)
|`gitlens.blame.ignoreWhitespace`|Specifies whether or not to ignore whitespace when comparing revisions during blame operations
|`gitlens.blame.separateLines`|Specifies whether or not gutter blame annotations will have line separators
#### Hover Settings
#### File Blame Annotation Settings
|Name | Description
|-----|------------
|`gitlens.blame.file.annotationType`|Specifies the type of blame annotations that will be shown for the current file<br/>`gutter` - adds an annotation to the beginning of each line<br/>`hover` - shows annotations when hovering over each line
|`gitlens.blame.file.lineHighlight.enabled`|Specifies whether or not to highlight lines associated with the current line
|`gitlens.blame.file.lineHighlight.locations`|Specifies where the associated line highlights will be shown<br/>`gutter` - adds a gutter glyph<br/>`line` - adds a full-line highlight background color<br/>`overviewRuler` - adds a decoration to the overviewRuler (scroll bar)
|`gitlens.annotations.file.gutter.format`|Specifies the format of the gutter blame annotations<br/>Available tokens<br/>`${id}` - commit id<br/>`${author}` - commit author<br/>`${message}` - commit message<br/>`${ago}` - relative commit date (e.g. 1 day ago)<br/>`${date}` - formatted commit date (format specified by `gitlens.annotations.file.gutter.dateFormat`)<br/>`${authorAgo}` - commit author, relative commit date<br/>See https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting
|`gitlens.annotations.file.gutter.dateFormat`|Specifies how to format absolute dates (using the `${date}` token) in gutter blame annotations<br/>See https://momentjs.com/docs/#/displaying/format/ for valid formats
|`gitlens.annotations.file.gutter.compact`|Specifies whether or not to compact (deduplicate) matching adjacent gutter blame annotations
|`gitlens.annotations.file.gutter.gravatars`|Specifies whether or not to show avatar images in the gutter blame annotations
|`gitlens.annotations.file.gutter.heatmap.enabled`|Specifies whether or not to provide a heatmap indicator in the gutter blame annotations
|`gitlens.annotations.file.gutter.heatmap.location`|Specifies where the heatmap indicators will be shown in the gutter blame annotations<br/>`left` - adds a heatmap indicator on the left edge of the gutter blame annotations<br/>`right` - adds a heatmap indicator on the right edge of the gutter blame annotations
|`gitlens.annotations.file.gutter.hover.details`|Specifies whether or not to provide a commit details hover annotation over the gutter blame annotations
|`gitlens.annotations.file.gutter.hover.changes`|Specifies whether or not to provide a changes (diff) hover annotation over the gutter blame annotations
|`gitlens.annotations.file.gutter.hover.wholeLine`|Specifies whether or not to trigger hover annotations over the whole line
|`gitlens.annotations.file.gutter.separateLines`|Specifies whether or not gutter blame annotations will have line separators
|`gitlens.annotations.file.hover.details`|Specifies whether or not to provide a commit details hover annotation over each line
|`gitlens.annotations.file.hover.changes`|Specifies whether or not to provide a changes (diff) hover annotation over each line
|`gitlens.annotations.file.hover.heatmap.enabled`|Specifies whether or not to provide heatmap indicators on the left edge of each line
#### Line Blame Annotation Settings
|Name | Description
|-----|------------
|`gitlens.blame.line.enabled`|Specifies whether or not to provide a blame annotation for the current line, by default<br/>Use the *Toggle Line Blame Annotations* command (`gitlens.toggleLineBlame`) to toggle the annotations on and off for the current session
|`gitlens.blame.line.annotationType`|Specifies the type of blame annotations that will be shown for the current line<br/>`trailing` - adds an annotation to the end of the current line<br/>`hover` - shows annotations when hovering over the current line
|`gitlens.annotations.line.trailing.format`|Specifies the format of the trailing blame annotations<br/>Available tokens<br/>`${id}` - commit id<br/>`${author}` - commit author<br/>`${message}` - commit message<br/>`${ago}` - relative commit date (e.g. 1 day ago)<br/>`${date}` - formatted commit date (format specified by `gitlens.annotations.line.trailing.dateFormat`)<br/>`${authorAgo}` - commit author, relative commit date<br/>See https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting
|`gitlens.annotations.line.trailing.dateFormat`|Specifies how to format absolute dates (using the `${date}` token) in trailing blame annotations<br/>See https://momentjs.com/docs/#/displaying/format/ for valid formats
|`gitlens.annotations.line.trailing.hover.details`|Specifies whether or not to provide a commit details hover annotation over the trailing blame annotations
|`gitlens.annotations.line.trailing.hover.changes`|Specifies whether or not to provide a changes (diff) hover annotation over the trailing blame annotations
|`gitlens.annotations.line.trailing.hover.wholeLine`|Specifies whether or not to trigger hover annotations over the whole line
|`gitlens.annotations.line.hover.details`|Specifies whether or not to provide a commit details hover annotation for the current line
|`gitlens.annotations.line.hover.changes`|Specifies whether or not to provide a changes (diff) hover annotation for the current line
### File Recent Changes Annotation Settings
### Hover Settings
|Name | Description
|-----|------------
|`gitlens.recentChanges.file.lineHighlight.locations`|Specifies where the highlights of the recently changed lines will be shown<br/>`gutter` - adds a gutter glyph<br/>`line` - adds a full-line highlight background color<br/>`overviewRuler` - adds a decoration to the overviewRuler (scroll bar)
|`gitlens.annotations.file.recentChanges.hover.details`|Specifies whether or not to provide a commit details hover annotation
|`gitlens.annotations.file.recentChanges.hover.changes`|Specifies whether or not to provide a changes (diff) hover annotation
### Custom Remotes Settings
|`gitlens.hovers.annotations.changes`|Specifies whether or not to provide a changes (diff) hover for all lines when showing blame annotations
|`gitlens.hovers.annotations.details`|Specifies whether or not to provide a commit details hover for all lines when showing blame annotations
|`gitlens.hovers.annotations.enabled`|Specifies whether or not to provide any hovers when showing blame annotations
|`gitlens.hovers.annotations.over`|Specifies when to trigger hovers when showing blame annotations<br/>`annotation` - only shown when hovering over the line annotation<br/>`line` - shown when hovering anywhere over the line
|`gitlens.hovers.currentLine.changes`|Specifies whether or not to provide a changes (diff) hover for the current line
|`gitlens.hovers.currentLine.details`|Specifies whether or not to provide a commit details hover for the current line
|`gitlens.hovers.currentLine.enabled`|Specifies whether or not to provide any hovers for the current line
|`gitlens.hovers.currentLine.over`|Specifies when to trigger hovers for the current line<br/>`annotation` - only shown when hovering over the line annotation<br/>`line` - shown when hovering anywhere over the line
|`gitlens.hovers.enabled`|Specifies whether or not to provide any hovers
|`gitlens.recentChanges.highlight.locations`|Specifies where the highlights of the recently changed lines will be shown<br/>`gutter` - adds a gutter glyph<br/>`line` - adds a full-line highlight background color<br/>`overviewRuler` - adds a decoration to the overviewRuler (scroll bar)
### Status Bar Settings
|Name | Description
|-----|------------
|`gitlens.statusBar.enabled`|Specifies whether or not to provide blame information on the status bar
|`gitlens.statusBar.alignment`|Specifies the blame alignment in the status bar<br/>`left` - align to the left, `right` - align to the right
|`gitlens.statusBar.command`|Specifies the command to be executed when the blame status bar item is clicked<br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.diffWithPrevious` - compares the current line commit with the previous<br/>`gitlens.diffWithWorking` - compares the current line commit with the working tree<br/>`gitlens.toggleCodeLens` - toggles Git code lens<br/>`gitlens.showQuickCommitDetails` - shows a commit details quick pick<br/>`gitlens.showQuickCommitFileDetails` - shows a commit file details quick pick<br/>`gitlens.showQuickFileHistory` - shows a file history quick pick<br/>`gitlens.showQuickRepoHistory` - shows a branch history quick pick
|`gitlens.statusBar.format`|Specifies the format of the blame information on the status bar<br/>Available tokens<br/>`${id}` - commit id<br/>`${author}` - commit author<br/>`${message}` - commit message<br/>`${ago}` - relative commit date (e.g. 1 day ago)<br/>`${date}` - formatted commit date (format specified by `gitlens.statusBar.dateFormat`)<br/>See https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting
|`gitlens.statusBar.dateFormat`|Specifies the date format of absolute dates shown in the blame information on the status bar<br/>See https://momentjs.com/docs/#/displaying/format/ for valid formats
### Strings Settings
|Name | Description
|-----|------------
|`gitlens.strings.codeLens.unsavedChanges.recentChangeAndAuthors`|Specifies the string to be shown in place of both the `recent change` and `authors` code lens when there are unsaved changes
|`gitlens.strings.codeLens.unsavedChanges.recentChangeOnly`|Specifies the string to be shown in place of the `recent change` code lens when there are unsaved changes
|`gitlens.strings.codeLens.unsavedChanges.authorsOnly`|Specifies the string to be shown in place of the `authors` code lens when there are unsaved changes
|`gitlens.statusBar.enabled`|Specifies whether or not to provide blame information on the status bar
|`gitlens.statusBar.format`|Specifies the format of the blame information on the status bar<br/>Available tokens<br/>`${id}` - commit id<br/>`${author}` - commit author<br/>`${message}` - commit message<br/>`${ago}` - relative commit date (e.g. 1 day ago)<br/>`${date}` - formatted commit date (format specified by `gitlens.statusBar.dateFormat`)<br/>See https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting
### Advanced Settings
@ -642,7 +580,7 @@ See also [Explorer Settings](#explorer-settings)
|-----|------------
|`gitlens.advanced.blame.delayAfterEdit`|Specifies the time (in milliseconds) to wait before re-blaming an unsaved document after an edit. Use 0 to specify an infinite wait
|`gitlens.advanced.blame.sizeThresholdAfterEdit`|Specifies the maximum document size (in lines) allowed to be re-blamed after an edit while still unsaved. Use 0 to specify no maximum
|`gitlens.advanced.caching.enabled`|Specifies whether git output will be cached -- changing the default is not recommended
|`gitlens.advanced.caching.enabled`|Specifies whether git output will be cached — changing the default is not recommended
|`gitlens.advanced.git`|Specifies the git path to use
|`gitlens.advanced.maxListItems`|Specifies the maximum number of items to show in a list. Use 0 to specify no maximum
|`gitlens.advanced.menus`|Specifies which commands will be added to which menus
@ -651,23 +589,59 @@ See also [Explorer Settings](#explorer-settings)
|`gitlens.advanced.repositorySearchDepth`|Specifies how many folders deep to search for repositories
|`gitlens.advanced.telemetry.enabled`|Specifies whether or not to enable GitLens telemetry (even if enabled still abides by the overall `telemetry.enableTelemetry` setting
|`gitlens.strings.codeLens.unsavedChanges.recentChangeAndAuthors`|Specifies the string to be shown in place of both the `recent change` and `authors` code lens when there are unsaved changes
|`gitlens.strings.codeLens.unsavedChanges.recentChangeOnly`|Specifies the string to be shown in place of the `recent change` code lens when there are unsaved changes
|`gitlens.strings.codeLens.unsavedChanges.authorsOnly`|Specifies the string to be shown in place of the `authors` code lens when there are unsaved changes
---
## Themable Colors
GitLens defines a set of themable colors which can be provided by vscode themes or directly by the user using [`workbench.colorCustomization`](https://code.visualstudio.com/docs/getstarted/themes#_customize-a-color-theme).
|Name | Description
|-----|------------
|`gitlens.gutterBackgroundColor`|Specifies the background color of the gutter blame annotations
|`gitlens.gutterForegroundColor`|Specifies the foreground color of the gutter blame annotations
|`gitlens.gutterUncommittedForegroundColor`|Specifies the foreground color of an uncommitted line in the gutter blame annotations
|`gitlens.trailingLineBackgroundColor`|Specifies the background color of the trailing blame annotation
|`gitlens.trailingLineForegroundColor`|Specifies the foreground color of the trailing blame annotation
|`gitlens.lineHighlightBackgroundColor`|Specifies the background color of the associated line highlights in blame annotations
|`gitlens.lineHighlightOverviewRulerColor`|Specifies the overview ruler color of the associated line highlights in blame annotations
---
## Insiders
Add [`"gitlens.insiders": true`](#general-settings "Jump to GitLens settings") to your settings to join the insiders channel and get early access to upcoming features. Be aware that because this provides early access expect there to be issues.
---
## Known Issues
- If the `Copy to * clipboard` commands don't work on Linux -- `xclip` needs to be installed. You can install it via `sudo apt-get install xclip`
- If the `Copy to * clipboard` commands don't work on Linux —`xclip` needs to be installed. You can install it via `sudo apt-get install xclip`
---
## Contributors
A big thanks to the people that have contributed to this project:
<pclass="page-header__subtitle">For advanced customizations refer to the <atitle="See the GitLens settings docs"href="https://github.com/eamodio/vscode-gitlens/tree/feature-settings#gitlens-settings">GitLens settings docs</a> and edit your
<pclass="page-header__subtitle">For advanced customizations refer to the <atitle="See the GitLens settings docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#gitlens-settings">GitLens settings docs</a> and edit your
<aclass="command"title="Open User Settings"href="command:workbench.action.openGlobalSettings">User Settings</a>
<pclass="section__title-hint">Adds on-demand Git blame annotations to the gutter for the whole file</p>
<pclass="section__title-hint">Adds on-demand gutter blame annotations for the whole file</p>
</div>
<divclass="section__settings">
<divclass="settings-group">
@ -341,6 +341,9 @@
<pclass="settings-group__hint">
<iclass="icon icon--lg icon__info"></i>
For more advanced customizations open <aclass="command"title="Open User Settings"href="command:workbench.action.openGlobalSettings">User Settings</a> and search for <b><i>gitlens.blame</i></b>
<span>
Press <spanclass="shortcut-key">Esc</span> to quickly turn off the annotations
See the <atitle="Open Release Notes"href="https://github.com/eamodio/vscode-gitlens/blob/feature-settings/CHANGELOG.md">Release Notes</a> for the full set of changes
See the <atitle="Open Release Notes"href="https://github.com/eamodio/vscode-gitlens/blob/develop/CHANGELOG.md">Release Notes</a> for the full set of changes
</p>
</section>
@ -50,7 +50,7 @@
GitLens is a free,
<aclass="bold"title="Open GitLens on GitHub"href="https://github.com/eamodio/vscode-gitlens">open-source</a> extension for Visual Studio Code created by
GitLens simply helps you understand code better. Quickly glimpse into who, why, and when a line or code block was changed.
@ -61,19 +61,22 @@
<ulclass="features-list">
<li>a <i>GitLens</i> explorer to navigate and explore repositories or file histories</li>
<li>an on-demand <i>GitLens Results</i> view to explore commits, histories, and searches, or visualize comparisions between branches, tags, commits, and more</li>
<li>Git authorship code lens showing the most recent commit and # of authors to the top of files and/or on code blocks</li>
<li>an unobtrusive Git blame annotation to the end of the current line</li>
<li>on-demand Git blame annotations, including a heatmap, to the gutter for the whole file</li>
<li>detailed Git blame information accessible via hovers</li>
<li>a status bar Git blame annotation showing author and date, by default, about the current line</li>
<li>many powerful commands for exploring commits and histories, comparing and navigating revisions, stash access, repository status, and more</li>
<li>authorship code lens showing the most recent commit and # of authors to the top of files and/or on code blocks</li>
<li>an unobtrusive current line blame annotation at the end of the line</li>
<li>on-demand gutter blame annotations, including a heatmap, for the whole file</li>
<li>detailed blame information accessible via hovers</li>
<li>on-demand recent changes annotations to highlight lines changed by the most recent commit</li>
<li>a status bar blame annotation showing author and date for the current line</li>
<li>commit search — by message, author, filename, commit id, or code changes</li>
<li>many powerful commands for exploring commits and histories, comparing and navigating revisions, stash access, repository status, etc</li>
<li>and so much more</li>
</ul>
</p>
<pclass="mb-2">GitLens is powerful, feature rich, and highly customizable to meet your specific needs
— find code lens intrusive or the current line blame annotation distracting —
no problem, it is quick and easy to turn them off or change how they behave via the built-in <aclass="command"title="Open GitLens Settings"href="command:gitlens.showSettingsPage">GitLens Settings</a> editor,
a WYSIWYG editor covering many of GitLens' powerful settings.
While for more advanced customizations, refer to the <atitle="Open the GitLens settings docs"href="https://github.com/eamodio/vscode-gitlens/tree/feature-settings#gitlens-settings">GitLens settings docs</a>
While for more advanced customizations, refer to the <atitle="Open the GitLens settings docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#gitlens-settings">GitLens settings docs</a>
and edit your <aclass="command"title="Open User Settings"href="command:workbench.action.openGlobalSettings">User Settings</a>.
Eric Amodio
6 년 전
