@ -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/).
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
### 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 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 *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
- 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
### Added
- Adds a **quick-access** command bar to the bottom of the **details** hover annotations
- 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.
> 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
#### Repository view
<palign="center">
<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>
</p>
The repository view provides a full Git repository explorer, which has the following features,
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
### History view
<palign="center">
<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>
</p>
The history view provides the revision history of the active file, which has the following features,
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
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)
- 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
### Current Line Blame
<palign="center">
<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>
</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
- 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
- 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
- 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
### Hovers
#### Current Line Hovers
#### Current Line Hovers
<palign="center">
<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>
</p>
- Adds [customizable](#hover-settings "Jump to the Hover settings") Git blame hovers accessible over the current line
- Adds [customizable](#hover-settings "Jump to the Hover settings") Git blame hovers accessible over the current line
##### Details Hover
##### Details Hover
<palign="center">
<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>
</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)
- 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
##### Changes (diff) Hover
<palign="center">
<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>
</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)
- 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)
- 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)
- 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
- 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
### Status Bar Blame
<palign="center">
<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>
</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)
- 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
#### Branch History
<palign="center">
<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>
</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
- 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
#### File History
<palign="center">
<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>
</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
- 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
- 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
- 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
- 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
#### Repository Status
<palign="center">
<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>
</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
- 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
- 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>
<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>
</p>
<divclass="settings-group__setting nowrap ml-1">
<divclass="settings-group__setting nowrap ml-1">
@ -66,24 +66,24 @@
</p>
</p>
<p>Here are just some of the features that GitLens provides,
<p>Here are just some of the features that GitLens provides,
<ulclass="features-list">
<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>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>
</ul>
</p>
</p>
<pclass="mb-2">GitLens is powerful, feature rich, and highly customizable to meet your specific needs
<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 —
— 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,
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.
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>.
and edit your <aclass="command"title="Open User Settings"href="command:workbench.action.openGlobalSettings">User Settings</a>.
Eric Amodio
6 years ago