@ -222,7 +222,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Adds the ability to control where the _GitLens_, _GitLens File History_, and _GitLens Results_ explorers are shown 🎉 — closes [#213](https://github.com/eamodio/vscode-gitlens/issues/213), [#377](https://github.com/eamodio/vscode-gitlens/issues/377)
- Adds `gitlens.gitExplorer.location` setting to the interactive settings editor to specify where the _GitLens_ explorer is shown — either in the _Explorer_ or _Source Control_ view
- Adds `gitlens.historyExplorer.location` setting to the interactive settings editor to specify where the _GitLens File History_ explorer is shown — either in the _Explorer_ or _Source Control_ view
- Adds `gitlens.resultsExplorer.location` setting to the interactive settings editor to specify where the _GitLens Results_ explorer is shown — either in the _Explorer_ or _Source Control_ view
- Adds `gitlens.resultsView.location` setting to the interactive settings editor to specify where the _GitLens Results_ explorer is shown — either in the _Explorer_ or _Source Control_ view
### Changed
@ -270,7 +270,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Adds a tree layout option to tags in the _GitLens_ explorer — closes [#358](https://github.com/eamodio/vscode-gitlens/issues/358)
- Adds _Show GitLens Explorer_ (`gitlens.showGitExplorer`) command — shows/expands the _GitLens_ explorer
- Adds _Show File History Explorer_ (`gitlens.showHistoryExplorer`) command — shows/expands the _GitLens File History_ explorer
- Adds _Show Results Explorer_ (`gitlens.showResultsExplorer`) command — shows/expands the _GitLens Results_ explorer
- Adds _Show Results Explorer_ (`gitlens.showResultsView`) command — shows/expands the _GitLens Results_ explorer
### Changed
@ -501,9 +501,9 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Renames _Show Files in Automatic View_ (`gitlens.gitExplorer.setFilesLayoutToAuto`) command to _Automatic Layout_
- Renames _Show Files in List View_ (`gitlens.gitExplorer.setFilesLayoutToList`) command to _List Layout_
- Renames _Show Files in Tree View_ (`gitlens.gitExplorer.setFilesLayoutToTree`) command to _Tree Layout_
- Renames _Show Files in Automatic View_ (`gitlens.resultsExplorer.setFilesLayoutToAuto`) command to _Automatic Layout_
- Renames _Show Files in List View_ (`gitlens.resultsExplorer.setFilesLayoutToAuto`) command to _List Layout_
- Renames _Show Files in Tree View_ (`gitlens.resultsExplorer.setFilesLayoutToAuto`) command to _Tree Layout_
- Renames _Show Files in Automatic View_ (`gitlens.resultsView.setFilesLayoutToAuto`) command to _Automatic Layout_
- Renames _Show Files in List View_ (`gitlens.resultsView.setFilesLayoutToAuto`) command to _List Layout_
- Renames _Show Files in Tree View_ (`gitlens.resultsView.setFilesLayoutToAuto`) command to _Tree Layout_
- Overhauls GitLens' settings for better clarity and ease-of-use
- Renames `gitlens.annotations.file.gutter.gravatars` setting to `gitlens.blame.avatars`
- Renames `gitlens.annotations.file.gutter.compact` setting to `gitlens.blame.compact`
@ -539,13 +539,13 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Removes `gitlens.codeLens.debug` setting, use `gitlens.debug` instead
- Removes `gitlens.blame.file.annotationType` setting, use `gitlens.hovers.annotations.enabled`
- Removes `gitlens.blame.line.annotationType` setting, use `gitlens.currentLine.enabled` or `gitlens.hovers.currentLine.enabled` instead
- Removes `gitlens.resultsExplorer.gravatars` setting, use `gitlens.explorers.avatars` instead
- Removes `gitlens.resultsExplorer.commitFileFormat` setting, use `gitlens.explorers.commitFileFormat` instead
- Removes `gitlens.resultsExplorer.commitFormat` setting, use `gitlens.explorers.commitFormat` instead
@ -669,7 +669,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Renames _Compare Line Revision with Working_ command (`gitlens.diffLineWithWorking`) to _Compare Line Revision with Working File_
- Renames _Open Changes with Working Tree_ command (`gitlens.openChangesWithWorking`) to _Open Changes with Working File_
- Deprecates `gitlens.gitExplorer.gravatarsDefault` setting, replaced by `gitlens.defaultGravatarsStyle`
- Deprecates `gitlens.resultsExplorer.gravatarsDefault` setting, replaced by `gitlens.defaultGravatarsStyle`
- Deprecates `gitlens.resultsView.gravatarsDefault` setting, replaced by `gitlens.defaultGravatarsStyle`
### Fixed
@ -750,8 +750,8 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
- Adds `gitlens.gitExplorer.gravatars` setting to specify whether to show gravatar images instead of commit (or status) icons in the _GitLens_ explorer
- Adds `gitlens.gitExplorer.gravatarsDefault` setting to specify the style of the gravatar default (fallback) images in the _GitLens_ explorer<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
- Adds `gitlens.resultsExplorer.gravatars` setting to specify whether to show gravatar images instead of commit (or status) icons in the _GitLens Results_ explorer
- Adds `gitlens.resultsExplorer.gravatarsDefault` setting to specify the style of the gravatar default (fallback) images in the _GitLens Results_ explorer<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
- Adds `gitlens.resultsView.gravatars` setting to specify whether to show gravatar images instead of commit (or status) icons in the _GitLens Results_ explorer
- Adds `gitlens.resultsView.gravatarsDefault` setting to specify the style of the gravatar default (fallback) images in the _GitLens Results_ explorer<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
- Adds _Select for Compare_ command (`gitlens.explorers.selectForCompare`) to branch, remote branch, tag, and revision (commit) nodes in the _GitLens_ explorer to mark the base reference of a comparison
- Adds _Compare with Selected_ command (`gitlens.explorers.compareWithSelected`) to branch, remote branch, tag, and revision (commit) nodes in the _GitLens_ explorer once another reference within the same repository has been selected to compare the current selection with the previously selected reference in the _GitLens Results_ explorer
<atitle="Learn more about GitLens"href="http://gitlens.amod.io"><imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/gitlens-logo.png"alt="GitLens Logo"/></a>
<atitle="Learn more about GitLens"href="http://gitlens.amod.io"><imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/docs/gitlens-logo.png"alt="GitLens Logo"/></a>
</p>
> 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.
@ -27,10 +27,10 @@ GitLens simply helps you understand code better. Quickly glimpse into whom, why,
Here are just some of the features that GitLens provides,
- a [_Repositories_ explorer](#repositories-explorer 'Jump to the Repositories explorer') to visualize, navigate, and explore Git repositories
- a [_File History_ explorer](#file-history-explorer 'Jump to the File History explorer') to visualize, navigate, and explore the revision history of the current file
- a [_Line History_ explorer](#line-history-explorer 'Jump to the Line History explorer') to visualize, navigate, and explore the revision history of the selected lines of current file
- an on-demand [_Results_ explorer](#results-explorer 'Jump to the Results explorer') to navigate and explore commits, histories, and searches, or visualize comparisons between branches, tags, commits, and more
- a [_Repositories_ view](#repositories-view 'Jump to the Repositories view') to visualize, navigate, and explore Git repositories
- a [_File History_ view](#file-history-view 'Jump to the File History view') to visualize, navigate, and explore the revision history of the current file
- a [_Line History_ view](#line-history-view 'Jump to the Line History view') to visualize, navigate, and explore the revision history of the selected lines of current file
- an on-demand [_Results_ view](#results-view 'Jump to the Results view') to navigate and explore commits, histories, and searches, or visualize comparisons between branches, tags, commits, and more
- [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
@ -81,7 +81,7 @@ None yet — could be you!
#### Bronze Sponsors ($50+)
- Michael Duffy
None yet — could be you!
## Configuration
@ -95,22 +95,22 @@ For more advanced customizations, refer to the [settings documentation](#gitlens
A [customizable](#repositories-explorer-settings 'Jump to the Repositories explorer settings') explorer to visualize, navigate, and explore Git repositories.
A [customizable](#repositories-view-settings 'Jump to the Repositories view settings') view to visualize, navigate, and explore Git repositories.
- A toolbar provides _Search Commits_, and _Refresh_ commands
- A context menu provides _Automatic Layout_, _List Layout_, _Tree Layout_, and _Enable Automatic Refresh_ or _Disable Automatic Refresh_ commands
The repositories explorer provides the following features,
The repositories view provides the following features,
- **Repository Status**
- Provides the name of the current branch, [optionally](#repositories-explorer-settings 'Jump to the Repositories explorer settings') its working tree status, and its upstream tracking branch and status (if available)
- Provides the name of the current branch, [optionally](#repositories-view-settings 'Jump to the Repositories view settings') its working tree status, and its upstream tracking branch and status (if available)
- Provides indicator dots on the repository icon which denote the following:
- _None_— up-to-date with the upstream
- _Green_— ahead of the upstream
@ -121,13 +121,13 @@ The repositories explorer provides the following features,
- is ahead of the upstream — quickly see and explore the specific commits ahead of the upstream (i.e. commits that haven't been pushed)
- A context menu provides _Open Repository on Remote_, and _Refresh_ commands
- **Changed Files**— lists all the "working" changes
- Expands to a file-based view of all changed files in the working tree ([optionally](#repositories-explorer-settings 'Jump to the Repositories explorer settings')) and/or all files in all commits ahead of the upstream
- Expands to a file-based view of all changed files in the working tree ([optionally](#repositories-view-settings 'Jump to the Repositories view settings')) and/or all files in all commits ahead of the upstream
- **History (current-branch)**— lists the revision (commit) history of the current branch
- See the _Branches expand_ section under **Branches** below for more details
- **Branches**— lists the local branches
- Indicates which branch is the current branch and [optionally](#repositories-explorer-settings 'Jump to the Repositories explorer settings') shows the remote tracking branch
- Indicates which branch is the current branch and [optionally](#repositories-view-settings 'Jump to the Repositories view settings') shows the remote tracking branch
- A context menu provides _Open Branches on Remote_, and _Refresh_ commands
- Branches expand to show its revision (commit) history
- Provides indicator dots on each branch icon which denote the following:
@ -173,18 +173,18 @@ The repositories explorer provides the following features,
---
### File History Explorer
### File History view
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/docs/file-history-explorer.png"alt="File History Explorer"/>
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/docs/file-history-explorer.png"alt="File History view"/>
</p>
A [customizable](#file-history-explorer-settings 'Jump to the File History explorer settings') explorer to visualize, navigate, and explore the revision history of the current file.
A [customizable](#file-history-view-settings 'Jump to the File History view settings') view to visualize, navigate, and explore the revision history of the current file.
- A toolbar provides a _Refresh_ command
- A context menu provides a _Follow Renames_ or _Don't Follow Renames_ command
The file history explorer provides the following features,
The file history view provides the following features,
- Automatically updates to track the current editor
- A context menu provides _Open File_, _Open File on Remote_ (if available), _Copy Remote File Url to Clipboard_ (if available), and _Refresh_ commands
@ -194,13 +194,13 @@ The file history explorer provides the following features,
---
### Line History Explorer
### Line History view
<palign="center">
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/docs/line-history-explorer.png"alt="Line History Explorer"/>
<imgsrc="https://raw.githubusercontent.com/eamodio/vscode-gitlens/develop/images/docs/line-history-explorer.png"alt="Line History view"/>
</p>
A [customizable](#line-history-explorer-settings 'Jump to the Line History explorer settings') explorer to visualize, navigate, and explore the revision history of the selected lines of current file.
A [customizable](#line-history-view-settings 'Jump to the Line History view settings') view to visualize, navigate, and explore the revision history of the selected lines of current file.
- A toolbar provides a _Refresh_ command
- A context menu provides a _Follow Renames_ or _Don't Follow Renames_ command
@ -215,18 +215,18 @@ The line history explorer provides the following features,
An on-demand, [customizable](#results-explorer-settings 'Jump to the Results explorer settings') explorer to navigate and explore commits, histories, and searches, or visualize comparisons between branches, tags, commits, and more
An on-demand, [customizable](#results-view-settings 'Jump to the Results view settings') view to navigate and explore commits, histories, and searches, or visualize comparisons between branches, tags, commits, and more
- A toolbar provides _Search Commits_, _Keep Results_, and _Refresh_ commands
- A context menu provides _Automatic Layout_, _List Layout_, _Tree Layout_, and _Close_ commands
The results explorer provides the following features,
The results view provides the following features,
#### Explore
@ -248,11 +248,11 @@ The results explorer provides the following features,
- Provides a semi-persistent results view for comparison operations
- Accessible via the following commands
- _Compare with Remote_ command (`gitlens.explorers.compareWithRemote`)
- _Compare with HEAD_ command (`gitlens.explorers.compareWithHead`)
- _Compare with Working Tree_ command (`gitlens.explorers.compareWithWorking`)
- _Compare with Selected_ command (`gitlens.explorers.compareWithSelected`)
- _Compare Ancestry with Working Tree_ command (`gitlens.explorers.compareAncestryWithWorking`)
- _Compare with Remote_ command (`gitlens.views.compareWithRemote`)
- _Compare with HEAD_ command (`gitlens.views.compareWithHead`)
- _Compare with Working Tree_ command (`gitlens.views.compareWithWorking`)
- _Compare with Selected_ command (`gitlens.views.compareWithSelected`)
- _Compare Ancestry with Working Tree_ command (`gitlens.views.compareAncestryWithWorking`)
- An inline toolbar provides _Swap Comparision_, and _Clear Results_ commands
- A context menu provides _Clear Results_, _Swap Comparision_, _Open Directory Compare_, and _Refresh_ commands
@ -454,7 +454,7 @@ The results explorer provides the following features,
- 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 _Results_explorer
- Provides a _Show in Results_ option to show the search results in the _Results_view
---
@ -635,65 +635,65 @@ GitLens is highly customizable and provides many configuration settings to allow
| `gitlens.settings.mode` | Specifies the display mode of the interactive settings editor<br/>`simple` - only displays common settings<br/>`advanced` - displays all settings |
| `gitlens.showWhatsNewAfterUpgrades` | Specifies whether to show What's New after upgrading to new feature releases |
### Repositories Explorer Settings
See also [Explorer Settings](#explorer-settings 'Jump to the Explorer settings')
| `gitlens.repositoriesExplorer.autoRefresh` | Specifies whether to automatically refresh the _Repositories_explorer when the repository or the file system changes |
| `gitlens.repositoriesExplorer.autoReveal` | Specifies whether to automatically reveal repositories in the _Repositories_explorer when opening files |
| `gitlens.repositoriesExplorer.branches.layout` | Specifies how the _Repositories_explorer will display branches<br/>`list` - displays branches as a list<br/>`tree` - displays branches as a tree when branch names contain slashes `/` |
| `gitlens.repositoriesExplorer.enabled` | Specifies whether to show the _Repositories_explorer |
| `gitlens.repositoriesExplorer.files.compact` | Specifies whether to compact (flatten) unnecessary file nesting in the _Repositories_explorer<br/>Only applies when `gitlens.repositoriesExplorer.files.layout` is set to `tree` or `auto` |
| `gitlens.repositoriesExplorer.files.layout` | Specifies how the _Repositories_explorer will display files<br/>`auto` - automatically switches between displaying files as a `tree` or `list` based on the `gitlens.repositoriesExplorer.files.threshold` value and the number of files at each nesting level<br/>`list` - displays files as a list<br/>`tree` - displays files as a tree |
| `gitlens.repositoriesExplorer.files.threshold` | Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Repositories_explorer<br/>Only applies when `gitlens.repositoriesExplorer.files.layout` is set to `auto` |
| `gitlens.repositoriesExplorer.includeWorkingTree` | Specifies whether to include working tree files inside the `Repository Status` node of the _Repositories_explorer |
| `gitlens.repositoriesExplorer.location` | Specifies where to show the _Repositories_explorer<br/>`gitlens` - adds to the GitLens view<br/>`explorer` - adds to the Explorer view<br/>`scm` - adds to the Source Control view |
| `gitlens.repositoriesExplorer.showTrackingBranch` | Specifies whether to show the tracking branch when displaying local branches in the _Repositories_explorer |
### File History Explorer Settings
See also [Explorer Settings](#explorer-settings 'Jump to the Explorer settings')
| `gitlens.fileHistoryExplorer.avatars` | Specifies whether to show avatar images instead of status icons in the _File History_explorer |
| `gitlens.fileHistoryExplorer.enabled` | Specifies whether to show the _File History_explorer |
| `gitlens.fileHistoryExplorer.location` | Specifies where to show the _File History_explorer<br/>`gitlens` - adds to the GitLens view<br/>`explorer` - adds to the Explorer view<br/>`scm` - adds to the Source Control view |
### Line History Explorer Settings
See also [Explorer Settings](#explorer-settings 'Jump to the Explorer settings')
| `gitlens.lineHistoryExplorer.avatars` | Specifies whether to show avatar images instead of status icons in the _Line History_explorer |
| `gitlens.lineHistoryExplorer.enabled` | Specifies whether to show the _Line History_explorer |
| `gitlens.lineHistoryExplorer.location` | Specifies where to show the _Line History_explorer<br/>`gitlens` - adds to the GitLens view<br/>`explorer` - adds to the Explorer view<br/>`scm` - adds to the Source Control view |
### Results Explorer Settings
See also [Explorer Settings](#explorer-settings 'Jump to the Explorer settings')
| `gitlens.resultsExplorer.files.compact` | Specifies whether to compact (flatten) unnecessary file nesting in the _Results_explorer<br/>Only applies when `gitlens.resultsExplorer.files.layout` is set to `tree` or `auto` |
| `gitlens.resultsExplorer.files.layout` | Specifies how the _Results_explorer will display files<br/>`auto` - automatically switches between displaying files as a `tree` or `list` based on the `gitlens.resultsExplorer.files.threshold` value and the number of files at each nesting level<br/>`list` - displays files as a list<br/>`tree` - displays files as a tree |
| `gitlens.resultsExplorer.files.threshold` | Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Results_explorer<br/>Only applies when `gitlens.resultsExplorer.files.layout` is set to `auto` |
| `gitlens.resultsExplorer.location` | Specifies where to show the _Results_explorer<br/>`gitlens` - adds to the GitLens view<br/>`explorer` - adds to the Explorer view<br/>`scm` - adds to the Source Control view |
| `gitlens.explorers.avatars` | Specifies whether to show avatar images instead of commit (or status) icons in the _Repositories_ and _Results_explorers |
| `gitlens.explorers.commitFileFormat` | Specifies the format of a committed file in the _Repositories_ and _Results_explorers<br/>Available tokens<br/> ${directory} - directory name<br/> ${file} - file name<br/> ${filePath} - formatted file name and path<br/> ${path} - full file path |
| `gitlens.explorers.commitFormat` | Specifies the format of committed changes in the _Repositories_ and _Results_explorers<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/> ${agoOrDate} - commit date specified by `gitlens.defaultDateStyle`<br/> ${authorAgo} - commit author, relative commit date<br/> ${authorAgoOrDate} - commit author, commit date specified by `gitlens.defaultDateStyle`<br/>See https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting |
| `gitlens.explorers.defaultItemLimit` | Specifies the default number of items to show in an explorer list. Use 0 to specify no limit |
| `gitlens.explorers.stashFileFormat` | Specifies the format of a stashed file in the _Repositories_ and _Results_explorers<br/>Available tokens<br/> ${directory} - directory name<br/> ${file} - file name<br/> ${filePath} - formatted file name and path<br/> ${path} - full file path |
| `gitlens.explorers.stashFormat` | Specifies the format of stashed changes in the _Repositories_ and _Results_explorers<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/> ${agoOrDate} - commit date specified by `gitlens.defaultDateStyle`<br/> ${authorAgo} - commit author, relative commit date<br/> ${authorAgoOrDate} - commit author, commit date specified by `gitlens.defaultDateStyle`<br/>See https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting |
| `gitlens.explorers.statusFileFormat` | Specifies the format of the status of a working or committed file in the _Repositories_explorer<br/>Available tokens<br/> ${directory} - directory name<br/> ${file} - file name<br/> ${filePath} - formatted file name and path<br/> ${path} - full file path<br/>${working} - optional indicator if the file is uncommitted |
### Repositories View Settings
See also [View Settings](#view-settings 'Jump to the View settings')
| `gitlens.views.repositories.autoRefresh` | Specifies whether to automatically refresh the _Repositories_view when the repository or the file system changes |
| `gitlens.views.repositories.autoReveal` | Specifies whether to automatically reveal repositories in the _Repositories_view when opening files |
| `gitlens.views.repositories.branches.layout` | Specifies how the _Repositories_view will display branches<br/>`list` - displays branches as a list<br/>`tree` - displays branches as a tree when branch names contain slashes `/` |
| `gitlens.views.repositories.enabled` | Specifies whether to show the _Repositories_view |
| `gitlens.views.repositories.files.compact` | Specifies whether to compact (flatten) unnecessary file nesting in the _Repositories_view<br/>Only applies when `gitlens.views.repositories.files.layout` is set to `tree` or `auto` |
| `gitlens.views.repositories.files.layout` | Specifies how the _Repositories_view will display files<br/>`auto` - automatically switches between displaying files as a `tree` or `list` based on the `gitlens.views.repositories.files.threshold` value and the number of files at each nesting level<br/>`list` - displays files as a list<br/>`tree` - displays files as a tree |
| `gitlens.views.repositories.files.threshold` | Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Repositories_view<br/>Only applies when `gitlens.views.repositories.files.layout` is set to `auto` |
| `gitlens.views.repositories.includeWorkingTree` | Specifies whether to include working tree files inside the `Repository Status` node of the _Repositories_view |
| `gitlens.views.repositories.location` | Specifies where to show the _Repositories_view<br/>`gitlens` - adds to the GitLens view<br/>`explorer` - adds to the Explorer view<br/>`scm` - adds to the Source Control view |
| `gitlens.views.repositories.showTrackingBranch` | Specifies whether to show the tracking branch when displaying local branches in the _Repositories_view |
### File History View Settings
See also [View Settings](#view-settings 'Jump to the View settings')
| `gitlens.views.fileHistory.avatars` | Specifies whether to show avatar images instead of status icons in the _File History_view |
| `gitlens.views.fileHistory.enabled` | Specifies whether to show the _File History_view |
| `gitlens.views.fileHistory.location` | Specifies where to show the _File History_view<br/>`gitlens` - adds to the GitLens view<br/>`explorer` - adds to the Explorer view<br/>`scm` - adds to the Source Control view |
### Line History View Settings
See also [View Settings](#view-settings 'Jump to the View settings')
| `gitlens.views.lineHistory.avatars` | Specifies whether to show avatar images instead of status icons in the _Line History_view |
| `gitlens.views.lineHistory.enabled` | Specifies whether to show the _Line History_view |
| `gitlens.views.lineHistory.location` | Specifies where to show the _Line History_view<br/>`gitlens` - adds to the GitLens view<br/>`explorer` - adds to the Explorer view<br/>`scm` - adds to the Source Control view |
### Results View Settings
See also [View Settings](#view-settings 'Jump to the View settings')
| `gitlens.views.results.files.compact` | Specifies whether to compact (flatten) unnecessary file nesting in the _Results_view<br/>Only applies when `gitlens.views.results.files.layout` is set to `tree` or `auto` |
| `gitlens.views.results.files.layout` | Specifies how the _Results_view will display files<br/>`auto` - automatically switches between displaying files as a `tree` or `list` based on the `gitlens.views.results.files.threshold` value and the number of files at each nesting level<br/>`list` - displays files as a list<br/>`tree` - displays files as a tree |
| `gitlens.views.results.files.threshold` | Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Results_view<br/>Only applies when `gitlens.views.results.files.layout` is set to `auto` |
| `gitlens.views.results.location` | Specifies where to show the _Results_view<br/>`gitlens` - adds to the GitLens view<br/>`explorer` - adds to the Explorer view<br/>`scm` - adds to the Source Control view |
| `gitlens.views.avatars` | Specifies whether to show avatar images instead of commit (or status) icons in the _Repositories_ and _Results_views |
| `gitlens.views.commitFileFormat` | Specifies the format of a committed file in the _Repositories_ and _Results_views<br/>Available tokens<br/> ${directory} - directory name<br/> ${file} - file name<br/> ${filePath} - formatted file name and path<br/> ${path} - full file path |
| `gitlens.views.commitFormat` | Specifies the format of committed changes in the _Repositories_ and _Results_views<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/> ${agoOrDate} - commit date specified by `gitlens.defaultDateStyle`<br/> ${authorAgo} - commit author, relative commit date<br/> ${authorAgoOrDate} - commit author, commit date specified by `gitlens.defaultDateStyle`<br/>See https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting |
| `gitlens.views.defaultItemLimit` | Specifies the default number of items to show in a view list. Use 0 to specify no limit |
| `gitlens.views.stashFileFormat` | Specifies the format of a stashed file in the _Repositories_ and _Results_views<br/>Available tokens<br/> ${directory} - directory name<br/> ${file} - file name<br/> ${filePath} - formatted file name and path<br/> ${path} - full file path |
| `gitlens.views.stashFormat` | Specifies the format of stashed changes in the _Repositories_ and _Results_views<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/> ${agoOrDate} - commit date specified by `gitlens.defaultDateStyle`<br/> ${authorAgo} - commit author, relative commit date<br/> ${authorAgoOrDate} - commit author, commit date specified by `gitlens.defaultDateStyle`<br/>See https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting |
| `gitlens.views.statusFileFormat` | Specifies the format of the status of a working or committed file in the _Repositories_view<br/>Available tokens<br/> ${directory} - directory name<br/> ${file} - file name<br/> ${filePath} - formatted file name and path<br/> ${path} - full file path<br/>${working} - optional indicator if the file is uncommitted |
Eric Amodio
6 years ago