- [**_Search & Compare_ view**](https://github.com/eamodio/vscode-gitlens#search-and-compare-view-) — search and explore commit histories by message, author, files, id, etc, or visualize comparisons between branches, tags, commits, and more
- Replaces the _Search Commits_ and _Compare Commits_ views
- Adds persistence (pinning) for both searches and comparisons
- Adds ability to edit existing searches
- Adds a new _Toggle History Mode_ command to the [**_File History_ view**](https://github.com/eamodio/vscode-gitlens#file-history-view-) — which integrates line history into the _File History_ view
- Adds staged changes to the [**_File History_ view**](https://github.com/eamodio/vscode-gitlens#file-history-view-)
- Adds support for showing history across all branches in the _File History_ view via the _Toggle Filter_ menu option — closes [#974](https://github.com/eamodio/vscode-gitlens/issues/974)
- Adds _Hide Avatars_ and _Show Avatars_ menu options to many GitLens views to hide or show avatars
- Adds new indicator icon to unpublished (unpushed) commits
- Reworks branch upstream status, including
- Adds [**terminal links**](https://github.com/eamodio/vscode-gitlens#terminal-links-) —`ctrl+click` on autolinks in the integrated terminal to quickly jump to more details for commits, branches, tags, and more
- Adds a user-friendly [**interactive rebase editor**](https://github.com/eamodio/vscode-gitlens#interactive-rebase-editor-) to easily configure an interactive rebase session
- (PREVIEW) Adds Pull Request information to line annotations and hovers (TODO: more details & image)
- Adds improved autolinks support
- Adds support for GitHub issues or pull requests in autolinks
- Adds issue titles to autolinks (if connected)
- Adds a new `alphanumeric` flag to autolinks — closes [#946](https://github.com/eamodio/vscode-gitlens/issues/946)
- Adds autolink support in plain text (as footnotes)
- Adds a new and improved _Gutter Heatmap_ file annotations (via the _Toggle File Heatmap Annotations_ command (`gitlens.toggleFileHeatmap`))
- (TODO: image)
- Adds [**rich integration**](https://github.com/eamodio/vscode-gitlens#remote-provider-integrations-) with GitHub
- Adds GitHub avatar support!
- Adds associated pull request to line annotations and hovers
- Adds associated pull request to status bar blame
- Adds associated pull requests to branches and commits in the GitLens views
- Adds autolinks for GitHub issues and pull requests, including titles, status, and authors
- Adds a new and improved [**_Gutter Heatmap_**](https://github.com/eamodio/vscode-gitlens#gutter-heatmap-) file annotations, via the _Toggle File Heatmap Annotations_ command (`gitlens.toggleFileHeatmap`)
- Displays the heatmap in the gutter for a cleaner look and avoids any code jumping
- Adds improved heatmap colorization for better clarity of old and new code
- Adds the hot/cold age threshold to GitLens interactive settings editor
- Adds a new and improved _Gutter Changes_ file annotations (via the _Toggle File Changes Annotations_ command (`gitlens.toggleFileChanges`)) — closes [#396](https://github.com/eamodio/vscode-gitlens/issues/396)
- (TODO: image)
- Adds a new and improved [**_Gutter Changes_**](https://github.com/eamodio/vscode-gitlens#gutter-changes-) file annotations, via the _Toggle File Changes Annotations_ command (`gitlens.toggleFileChanges`) — closes [#396](https://github.com/eamodio/vscode-gitlens/issues/396)
- Adds improved titles for better clarity, context, and flow
- Adds a new _history_ (log) command to show the commit history of a branch or tag
- Adds a _Reveal in Side Bar_ button to the quick pick menu toolbar
- Adds keyboard navigation
@ -51,47 +71,66 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- `alt+right arrow`— searches for the selected commit and shows the results in the _Search Commits_ view
- `ctrl+right arrow`, `cmd+right arrow` (macOS) — reveals the selected commit in the _Commits_ view (or _Repositories_ view, if enabled)
- Adds a new _status_ command to show the current respository status
- Adds a new _Delete Branch & Remote_&_Force Delete Branch & Remote_ options to the _branch delete_ command — to more easily delete branches with tracking branches
- Adds a new _Delete Branch & Remote_and_Force Delete Branch & Remote_ options to the _branch delete_ command — to more easily delete branches with tracking branches
- Adds ability pull (fetch) a specific branch(es) to the _pull_ command — closes [#873](https://github.com/eamodio/vscode-gitlens/issues/873)
- Adds a new _Publish Branch_ option to the _push_ command
- Adds ability to push a single branch to the _push_ command
- Adds a new _Soft Reset_ (`--soft`) option to the _reset_ command
- Adds a new _Toggle File/Line History_ command to the _File History_ view — which integrates line history into the _File History_ view
- Adds staged changes to the _File History_ and _Line History_ views
- Adds a new _Open File from Remote_ (`gitlens.openFileFromRemote`) command — opens the local file from a remote file url
- Adds a new _Copy Remote Commit Url_ (`gitlens.copyRemoteCommitUrl`) command — copies the remote url of the current line commit to the clipboard
- Adds new `alt` commands for many of the _Open \* on Remote_ commands to alternatively copy the url to the clipboard
- Overhauls all GitLens contributed menus to reduce noise and improve usability
- Adds improved autolinks support
- Adds a new `alphanumeric` flag to autolinks — closes [#946](https://github.com/eamodio/vscode-gitlens/issues/946)
- Adds autolink support in plain text (as footnotes)
- Adds `alt+click` commands for many of the _Open \* on Remote_ commands to alternatively copy the url to the clipboard
- Adds new ability to set the default remote from any of the _Open \* on Remote_ command quick pick menus
- Adds much improved co-author support
- Provides an updatable quick pick of co-authors
- Adds the _Add Co-authors_ (`gitlens.addAuthors`) command to the Source Control toolbar
- Adds an option to the _Menus & Toolbars_ section of GitLens interactive settings editor to show/hide the _Add Co-authors_ command on the Source Control toolbar
- Adds new _Git Code Lens_ options to disable the click actions on both the recent change and authors code lens — closes [#989](https://github.com/eamodio/vscode-gitlens/issues/989) thanks to [PR #1009](https://github.com/eamodio/vscode-gitlens/pull/1009) by Abdulrahman (Abdu) Assabri ([@abdusabri](https://github.com/abdusabri))
- Adds per-language customizations to the `gitlens.codeLens.scopes` and `gitlens.codeLens.symbolScopes` settings — closes [#977](https://github.com/eamodio/vscode-gitlens/issues/977)
- Adds _Git Code Lens_ markdown headers
- Adds many new commands
- _Open File from Remote_ (`gitlens.openFileFromRemote`) command — opens the local file from a remote file url
- _Set Views Layout_ (`gitlens.setViewsLayout`) command — quickly switch between showing GitLens views in _GitLens_ sidebar (default) and the _Source Control_ sidebar
- Adds a _Switch to Another Branch_ (`gitlens.views.switchToAnotherBranch`) command — to quickly switch the current branch
- _Copy Remote Commit Url_ command (`gitlens.copyRemoteCommitUrl`) — copies the url of the current line commit on the remote provider
- _Copy Remote Branch Url_ command (`gitlens.copyRemoteBranchUrl`) — copies the url of a branch on the remote provider
- _Copy Remote Branches Url_ command (`gitlens.copyRemoteBranchesUrl`) — copies the url of the branches on the remote provider
- _Open Comparison on Remote_ command (`gitlens.openComparisonOnRemote`) — opens the comparison on the remote provider
- _Copy Remote Comparison Url_ command (`gitlens.copyRemoteComparisonUrl`) — copies the url of the comparison on the remote provider
- _Open Pull Request_ command (`gitlens.openPullRequestOnRemote`) — opens the pull request on the remote provider
- _Copy Pull Request Url_ command (`gitlens.copyRemotePullRequestUrl`) — copies the url of the pull request on the remote provider
- _Copy Remote Repository Url_ command (`gitlens.copyRemoteRepositoryUrl`) — copies the url of the repository on the remote provider
- Adds an _Open Commit on Remote_ command (with an _Copy Remote Commit Url_`alt+click` command) to commits in the VS Code Timeline view
- Adds a new default click action on changed files nodes in GitLens views to open all changes
- Adds a new `gitlens.hovers.avatarSize` setting to customize the size of avatars shown in hovers
- Increases the default avatar size in hovers from 16px to 32px
- Adds new _Welcome_ and _Open Settings_ menu options to the GitLens context/gear menu in the _Extensions_ sidebar — closes [#952](https://github.com/eamodio/vscode-gitlens/issues/952) & [#953](https://github.com/eamodio/vscode-gitlens/issues/953) thanks to [PR #992](https://github.com/eamodio/vscode-gitlens/pull/992) by Zeeshan Adnan ([@zeeshanadnan](https://github.com/zeeshanadnan))
- Adds a new _Set Views Layout_ (`gitlens.setViewsLayout`) command — quickly switch between showing GitLens views in _GitLens_ sidebar (default) and the _Source Control_ sidebar
- Adds a _Clear_ command to branch comparison nodes in the _Commits_ and _Repositories_ views
- Adds a _Hide Branch Comparison_ command to branch comparison nodes in the _Commits_ view
- Adds a _Hide/Show Branch Comparison_ toggle command to the _Commits_ views
- Adds HEAD option to compare quick pick menu — closes [#927](https://github.com/eamodio/vscode-gitlens/issues/927)
- Adds per-language customizations to the `gitlens.codeLens.scopes` and `gitlens.codeLens.symbolScopes` settings — closes [#977](https://github.com/eamodio/vscode-gitlens/issues/977)
- Adds support for showing history across all branches in the _File History_ view via the _Show Commits from All Branches_ menu option — closes [#974](https://github.com/eamodio/vscode-gitlens/issues/974)
- Adds support for `.gitattributes` text conversion filters — closes [#866](https://github.com/eamodio/vscode-gitlens/issues/866) thanks to [PR #1052](https://github.com/eamodio/vscode-gitlens/pull/1052) by Martin Campbell ([@martin-css](https://github.com/martin-css))
- Adds a _Switch to Another Branch_ (`gitlens.views.switchToAnotherBranch`) command — to quickly switch the current branch
- Adds a menu option to GitLens views to show or hide avatars
- Adds week(s) ago to relative time formatting
- Adds real-time preview when editing format strings in the GitLens interactive settings editor
- Adds a new commit format tokens: `${authorNotYou}`, `${agoOrDateShort}`, `${authorAgoOrDateShort}`, `${committerAgoOrDateShort}`
- Adds compact mode for showing branch and tag tips on commits
- Adds toggle for relative date markers in GitLens views
- Adds _Copy SHA_ command to branches and tags
- Adds a limit of 5000 commits to the _Load All_ command
- Adds synchronized storage to avoid Welcome page and upgrade notifications on new machines with Settings Sync
### Changed
- Changes all GitLens views to be on the Source Control side bar by default, but you can still move them all to the GitLens side bar via the _Set Views Layout_ (`gitlens.setViewsLayout`) command or individually via drag and drop
- Integrates the _Line History_ view into the _File History_ view, although the old _Line History_ view can be re-enabled by setting `"gitlens.views.lineHistory.enabled": true` or via the GitLens Interactive Settings
- File vs Line History can be toggled via the _Toggle File/Line History_ command in the view's toolbar
- Changes the _Repositories_ view to be disabled by default, as it has been superseded by the many new views. It can be re-enabled by setting `"gitlens.views.repositories.enabled": true` or via the GitLens Interactive Settings
- Deprecates and integrates the _Line History_ view into the _File History_ view, although the old _Line History_ view can be re-enabled by setting `"gitlens.views.lineHistory.enabled": true` (although it will likely be removed in a future version)
- File vs Line History can be toggled via the _Toggle History Mode_ command in the view's toolbar
- Renames _Pause/Resume File Tracking_ toggle to be _Pin/Unpin the Current File History_
- Adds improved titles for better clarity, context, and flow
- Removes the _Keep Open_ toggle button to the quick pick menu toolbar — the behavior is now automatically determined (unless overridden by the `gitlens.gitCommands.closeOnFocusOut` setting)
- Changes comparisons results into ahead and behind groups
- Changes the _Open Settings_ and _Welcome_ pages to open beside the active editor
- Changes avatars in the blame file annotations to new be displayed as part of the annotations rather than in the gutter
- Changes the _Git Command Palette_'s _push_ command to honor and reflect the `git.useForcePushWithLease` setting
- Changes to use VS Code's built-in icons (codicons) where possible — closes [#985](https://github.com/eamodio/vscode-gitlens/issues/985)
@ -99,29 +138,62 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Changes to use codicons in hovers — closes [#954](https://github.com/eamodio/vscode-gitlens/issues/954)
- Changes revision navigation icons to better match VS Code
- Changes _Show More_ to _Load more_ in GitLens views
- Changes the date markers in GitLens views to be less prominent, and avoids showing the marker if it is first item
- Changes the sorting of branches so that _main_, _master_, and _develop_ are at the top
- Changes the sorting of remotes so that _origin_ is at the top — closes [#924](https://github.com/eamodio/vscode-gitlens/issues/924) — thanks to [PR #925](https://github.com/eamodio/vscode-gitlens/pull/925) by Connor Peet ([@connor4312](https://github.com/connor4312))
- Changes the sorting of branch and tag pickers to be by date descending
- Changes the sorting of remotes so that _origin_ is at the top — closes [#924](https://github.com/eamodio/vscode-gitlens/issues/924) — thanks to [PR #925](https://github.com/eamodio/vscode-gitlens/pull/925) - Changes the sorting of branches and tags in the _Git Commands Palette_ to be by date descending
- Changes the default sorting of tags to be by date descending
by Connor Peet ([@connor4312](https://github.com/connor4312))
- Changes to allow autolinks inside parentheses and square brackets
- Changes the default current line format to show the message before the author
- Changes the default blame annotation format to show 50 characters (instead of 40)
- Changes the comparison icons in GitLens views
- Changes to use the `onStartupFinished` activation to avoid slowing down VS Code startup
- Changes `gitlens.strings.codeLens.unsavedChanges.*` settings defaults to be much less intrusive now
- Renames _Show Commit Details_ command to _Show Commit_
- Renames _Show More_ command in views to _Load more_
- Aligns many commit quick pick menu commands and commit context menu commands
- Replaces _Push to Commit (via Terminal)_ command with a new _Push to Commit_ command
- Swaps the order of _Open Revision_ and _Open File_ on file revisions
- Updates emoji support in commit messages
- Limits `scm/resourceGroup/context` and `scm/resourceState/context` menu contributions
- Optimizes file system watcher for repository changes (ignores .gitignored files)
- Improves the performance of the _Details_ hover
- Improves the performance of the _Contributors_ node in the _Repositories_ view
- Improves the performance (and experience) when opening multiple files or revisions
- Marks the current user with a `(you)` suffix and moves it to the top of the _Contributors_ node in the _Repositories_ view
- Deprecates the `gitlens.codeLens.scopesByLanguage` setting. Use per-language `gitlens.codeLens.scopes`and`gitlens.codeLens.symbolScopes` settings instead
- Deprecates the `gitlens.codeLens.scopesByLanguage` setting, use per-language `gitlens.codeLens.scopes`and`gitlens.codeLens.symbolScopes` settings instead
- Deprecates the `gitlens.gitCommands.search.showResultsInView` setting as it has been renamed to `gitlens.gitCommands.search.showResultsInSideBar`
- Deprecates the `gitlens.views.commitFileFormat` setting, use `gitlens.views.formats.files.label` instead
- Deprecates the `gitlens.views.commitFileDescriptionFormat` setting, use `gitlens.views.formats.files.description` instead
- Deprecates the `gitlens.views.commitFormat` setting, use `gitlens.views.formats.commits.label` instead
- Deprecates the `gitlens.views.commitDescriptionFormat` setting, use `gitlens.views.formats.commits.description` instead
- Deprecates the `gitlens.views.stashFileFormat` setting, use `gitlens.views.formats.files.label` instead
- Deprecates the `gitlens.views.stashFileDescriptionFormat` setting, use `gitlens.views.formats.files.description` instead
- Deprecates the `gitlens.views.stashFormat` setting, use `gitlens.views.formats.stashes.label` instead
- Deprecates the `gitlens.views.stashDescriptionFormat` setting, use `gitlens.views.formats.stashes.description` instead
- Deprecates the `gitlens.views.statusFileFormat` setting, use `gitlens.views.formats.files.label` instead
- Deprecates the `gitlens.views.statusFileDescriptionFormat` setting, use `gitlens.views.formats.files.description` instead
- Removes unneeded collapse all from the _File History_ view
- Removes the associated commit sha from tag descriptions
- Removes `${changes}` token from commit description format by default
- Removes the _Keep Open_ toggle button on the _Git Command Palette_ toolbar — the behavior is now automatically determined (unless overridden by the `gitlens.gitCommands.closeOnFocusOut` setting)
- Removes the heart icon from all GitLens views and simplifies the sponsor command
- Removes many view visibility (enablement) settings as the control over a views visibility is more easily controlled directly by unchecking the view itself
- Removes the `gitlens.views.repositories.showTrackingBranch` setting as it is now always enabled
### Fixed
- Fixes diffs of renamed files in certain cases
- Fixes [#1139](https://github.com/eamodio/vscode-gitlens/issues/1139) - Git crash with v2.29.x
- Fixes typo forcably -> forcibly — thanks to [PR #1138](https://github.com/eamodio/vscode-gitlens/pull/1138) by Andrea Cigana ([@ciganandrea](https://github.com/ciganandrea))
- Fixes missing empty (non-merge) commits
- Fixes issue with a blank branch name before any commits exist
- Fixes issues with missing repository or file system change events while vs code is unfocused
- Fixes remote url issues with spaces in the filename
- Fixes issue where <remote>/HEAD was showing up as a branch
- Fixes issues with revision navigation commands and diff editors
- Fixes show command with single file commits
- Fixes delete of remote branches on the _Git Command Palette_'s _branch_ command
- Fixes _Git Command Palette_'s back tracking in certain cases
- Fixes issue to ensure that dropping a stash drops the correct item even if the view is out of date
@ -59,8 +59,8 @@ Here are just some of the **features** that GitLens provides,
- [commits](#quick-commit-access- 'Jump to Quick Commit Access') — history and search
- [stashes](#quick-stash-access- 'Jump to Quick Stash Access')
- [status](#quick-status-access- 'Jump to Quick Status Access') — current branch and working tree status
- a user-friendly [**interactive rebase editor**](#interactive-rebase-editor- 'Jump to the Interactive Rebase Editor') to more easily configure an interactive rebase session
- [**terminal links**](#terminal-links- 'Jump to Terminal Links') — ctrl+click on auto-links in the integrated terminal to quickly jump to more details for commits, branches, tags, and more
- a user-friendly [**interactive rebase editor**](#interactive-rebase-editor- 'Jump to the Interactive Rebase Editor') to easily configure an interactive rebase session
- [**terminal links**](#terminal-links- 'Jump to Terminal Links') —`ctrl+click` on autolinks in the integrated terminal to quickly jump to more details for commits, branches, tags, and more
@ -256,7 +256,7 @@ The _Commits_ view lists all of the commits on the current branch, and additiona
- **Ahead**— lists the commits that the current branch has (i.e. ahead) but are missing in the selected reference
- **# files changed**— lists all of the files changed between the compared references
- the current branch status — shows the upstream status of the current branch
- **Publish <current branch> to remote**— shown when the current branch has not been published to a remote
- **Publish <current branch> to <remote>**— shown when the current branch has not been published to a remote
- **Up to date with <remote>**— shown when the current branch is up to date with the upstream remote
- **Changes to push to <remote>**— lists of all the files changed in the unpublished commits when the current branch has (unpublished) commits that waiting to be pushed to the upstream remote
- **Changes to pull from <remote>**— lists all of the commits waiting to be pulled when the current branch has commits that are waiting to be pulled from the upstream remote
@ -306,6 +306,7 @@ The _Branches_ view lists all of the local branches, and additionally provides,
- **Ahead**— lists the commits that the branch has (i.e. ahead) but are missing in the selected reference
- **# files changed**— lists all of the files changed between the compared references
- the branch status — shows the upstream status of the branch
- **Publish <branch> to <remote>**— shown when the current branch has not been published to a remote
- **Changes to push to <remote>**— lists of all the files changed in the unpublished commits when the branch has (unpublished) commits that waiting to be pushed to the upstream remote
- **Changes to pull from <remote>**— lists all of the commits waiting to be pulled when the branch has commits that are waiting to be pulled from the upstream remote
- any associated pull request — shows any pull request associated with the branch
@ -377,8 +378,7 @@ The _Contributors_ view lists all of the contributors, and additionally provides
A [customizable](#search-&-compare-view-settings- 'Jump to the Search & Compare view settings'), hidden by default, view to search and explore commit histories by message, author, files, id, etc, or visualize comparisons between
branches, tags, commits, and more
A [customizable](#search-&-compare-view-settings- 'Jump to the Search & Compare view settings'), hidden by default, view to search and explore commit histories by message, author, files, id, etc, or visualize comparisons between branches, tags, commits, and more
The _Search & Compare_ view lists pinnable (saved) results for searching commit histories or for comparison operations, and additionally provides,
@ -414,7 +414,7 @@ The _Search & Compare_ view lists pinnable (saved) results for searching commit
A [customizable](#repositories-view-settings- 'Jump to the Repositories view settings'), hidden by default (as it has been superseded by the new views), view to visualize, navigate, and explore Git repositories
A [customizable](#repositories-view-settings- 'Jump to the Repositories view settings'), hidden by default as it has been superseded by the new views, view to visualize, navigate, and explore Git repositories
The Repositories view lists opened Git repositories, and additionally provides,
@ -527,14 +527,14 @@ The Repositories view lists opened Git repositories, and additionally provides,
GitLens provides rich integrations with many remote providers, including GitHub, GitHub Enterprise, GitLab, Bitbucket, Bitbucket Server, Azure DevOps. You can also define [custom remote providers](#custom-remotes-settings 'Jump to the Custom Remotes settings') or [remote providers with custom domains](#custom-remotes-settings 'Jump to the Custom Remotes settings') as well.
Basic integrations provide issue and pull request auto-linking, while richer integrations (e.g. GitHub) can provide rich hover information provided for auto-linked issues and pull requests, and associate pull requests with branches and commits.
Basic integrations provide issue and pull request auto-linking, while richer integrations (e.g. GitHub) can provide rich hover information provided for auto-linked issues and pull requests, associate pull requests with branches and commits, and provide avatars.
Additionally, these integrations provide commands to copy the url of or open, files, commits, branches, and the repository on the remote provider.
@ -561,6 +561,8 @@ Additionally, these integrations provide commands to copy the url of or open, fi
- Adds a _Copy SHA_ command (`gitlens.copyShaToClipboard`) to copy the commit id (sha) of the current line to the clipboard or from the most recent commit to the current branch, if there is no current editor
- Adds a _Copy Message_ command (`gitlens.copyMessageToClipboard`) to copy the commit message of the current line to the clipboard or from the most recent commit to the current branch, if there is no current editor
- Adds a _Switch to Another Branch_ (`gitlens.views.switchToAnotherBranch`) command — to quickly switch the current branch
- Adds a _Compare HEAD with..._ command (`gitlens.diffHeadWith`) to compare the index (HEAD) with the selected reference
- Adds a _Compare Working Tree with..._ command (`gitlens.diffWorkingWith`) to compare the working tree with the selected reference
Eric Amodio
4 年之前
