@ -4,10 +4,10 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/).
## [8.0.0-rc] - 2018-02-06
## [8.0.0] - 2018-02-07
### 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— closes [#51](https://github.com/eamodio/vscode-gitlens/issues/51)
- 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— closes [#167](https://github.com/eamodio/vscode-gitlens/issues/167)
- Adds a tree layout option to branches in the *GitLens* explorer — closes [#258](https://github.com/eamodio/vscode-gitlens/issues/258) thanks to [PR #260](https://github.com/eamodio/vscode-gitlens/pull/260) by Yukai Huang ([@Yukaii](https://github.com/Yukaii))!
- Adds *Follow Renames* command (`gitlens.gitExplorer.setRenameFollowingOn`) to the **GitLens** explorer *History* view to follow file renames in the history
- Adds *Don't Follow Renames* command (`gitlens.gitExplorer.setRenameFollowingOff`) to the **GitLens** explorer *History* view to not follow file renames in the history
@ -481,7 +481,7 @@ 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
> 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.
@ -35,7 +35,7 @@ GitLens is powerful, feature rich, and also [highly customizable](#gitlens-setti
@ -60,7 +60,7 @@ A [customizable](#gitlens-explorer-settings "Jump to the GitLens Explorer settin
#### Repository view
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-gitlens-explorer-repository.png"alt="GitLens Explorer Repository view"/>
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/master/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,
@ -123,7 +123,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/develop/images/ss-gitlens-explorer-history.png"alt="GitLens Explorer History view"/>
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/master/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,
@ -135,7 +135,7 @@ The history view provides the revision history of the active file, which has the
An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens Results view settings") view to explore commits, histories, and searches, or visualize comparisons between branches, tags, commits, and more
@ -176,7 +176,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- 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)
@ -200,7 +200,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
---
### Current Line Blame
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-current-line-blame.png"alt="Current Line Blame"/>
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/master/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"), **blame annotation** at the end of the current line
@ -211,7 +211,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- 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
@ -225,7 +225,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- Adds an on-demand **heatmap** to the edge of the gutter to show the relative age of a line
@ -237,14 +237,14 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
### 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"/>
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/master/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"/>
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/master/images/ss-hovers-current-line-details.png"alt="Current Line Details Hover"/>
</p>
- 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)
@ -253,7 +253,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
##### 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"/>
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/master/images/ss-hovers-current-line-changes.png"alt="Current Line Changes (diff) Hover"/>
</p>
- 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)
@ -262,14 +262,14 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- 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)
@ -278,7 +278,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- 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)
@ -288,7 +288,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- 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
@ -298,7 +298,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
---
### Status Bar Blame
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/ss-status-bar.png"alt="Status Bar Blame"/>
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/master/images/ss-status-bar.png"alt="Status Bar Blame"/>
</p>
- 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)
@ -342,7 +342,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
#### 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"/>
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/master/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
@ -355,7 +355,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
#### 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"/>
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/master/images/ss-menu-file-history.png"alt="File History Quick Pick Menu"/>
</p>
- 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
@ -365,7 +365,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- 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
@ -376,7 +376,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- 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
@ -386,7 +386,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
#### 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"/>
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/master/images/ss-menu-repo-status.png"alt="Repository Status Quick Pick Menu"/>
</p>
- 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
@ -400,7 +400,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
- Adds a *Show Stashed Changes* command (`gitlens.showQuickStashList`) to show a **stashed changes quick pick menu** for exploring your repository stash history
@ -412,7 +412,7 @@ An on-demand, [customizable](#gitlens-results-view-settings "Jump to the GitLens
<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
<pclass="page-header__subtitle">For advanced customizations refer to the <atitle="See the GitLens settings docs"href="https://github.com/eamodio/vscode-gitlens/#gitlens-settings">GitLens settings docs</a> and edit your
<aclass="command"title="Open User Settings"href="command:workbench.action.openGlobalSettings">User Settings</a>
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
See the <atitle="Open Release Notes"href="https://github.com/eamodio/vscode-gitlens/blob/master/CHANGELOG.md">Release Notes</a> for the full set of changes
</p>
<divclass="settings-group__setting nowrap ml-1">
@ -66,24 +66,24 @@
</p>
<p>Here are just some of the features that GitLens provides,
<ulclass="features-list">
<li>a <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#gitlens-explorer"><i>GitLens</i> explorer</a> to navigate and explore repositories or file histories</li>
<li>an on-demand <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#gitlens-results-view"><i>GitLens Results</i> view</a> to explore commits, histories, and searches, or visualize comparisons between branches, tags, commits, and more</li>
<li>authorship <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#code-lens">code lens</a> showing the most recent commit and # of authors to the top of files and/or on code blocks</li>
<li>an unobtrusive <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#current-line-blame">current line blame</a> annotation at the end of the line</li>
<li>on-demand <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#gutter-blame">gutter blame</a> annotations, including a heatmap, for the whole file</li>
<li>detailed blame information accessible via <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#hovers">hovers</a></li>
<li>on-demand <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#recent-changes">recent changes</a> annotations to highlight lines changed by the most recent commit</li>
<li>a <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#status-bar-blame">status bar blame</a> annotation showing author and date for the current line</li>
<li><atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#commit-search">commit search</a>— by message, author, filename, commit id, or code changes</li>
<li>a <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/#gitlens-explorer"><i>GitLens</i> explorer</a> to navigate and explore repositories or file histories</li>
<li>an on-demand <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/#gitlens-results-view"><i>GitLens Results</i> view</a> to explore commits, histories, and searches, or visualize comparisons between branches, tags, commits, and more</li>
<li>authorship <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/#code-lens">code lens</a> showing the most recent commit and # of authors to the top of files and/or on code blocks</li>
<li>an unobtrusive <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/#current-line-blame">current line blame</a> annotation at the end of the line</li>
<li>on-demand <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/#gutter-blame">gutter blame</a> annotations, including a heatmap, for the whole file</li>
<li>detailed blame information accessible via <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/#hovers">hovers</a></li>
<li>on-demand <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/#recent-changes">recent changes</a> annotations to highlight lines changed by the most recent commit</li>
<li>a <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/#status-bar-blame">status bar blame</a> annotation showing author and date for the current line</li>
<li><atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/#commit-search">commit search</a>— 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 <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#features">more</a></li>
<li>and so much <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/#features">more</a></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 docs"href="https://github.com/eamodio/vscode-gitlens/tree/develop#gitlens-settings">GitLens settings docs</a>
While for more advanced customizations, refer to the <atitle="Open the GitLens docs"href="https://github.com/eamodio/vscode-gitlens/#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 lat temu