| `gitlens.defaultDateFormat` | Specifies how absolute dates will be formatted by default<br/>See https://momentjs.com/docs/#/displaying/format/ for valid formats |
| `gitlens.defaultDateStyle` | Specifies how dates will be displayed by default |
| `gitlens.defaultGravatarsStyle` | Specifies the style of the gravatar default (fallback) images<br/>`identicon` - a geometric pattern<br/>`mm` - 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` - a face with differing features and backgrounds |
| `gitlens.insiders` | Specifies whether to enable experimental features |
| `gitlens.keymap` | Specifies the keymap to use for GitLens shortcut keys<br/>`alternate` - adds an alternate set of shortcut keys that start with `Alt` (⌥ on macOS)<br/>`chorded` - adds a chorded set of shortcut keys that start with `Ctrl+Shift+G` (<code>⌥⌘G</code> on macOS)<br/>`none` - no shortcut keys will be added |
| `gitlens.menus` | Specifies which commands will be added to which menus |
| `gitlens.outputLevel` | Specifies how much (if any) output will be sent to the GitLens output channel |
| `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 |
| `gitlens.defaultDateFormat` | Specifies how absolute dates will be formatted by default. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats |
| `gitlens.defaultDateStyle` | Specifies how dates will be displayed by default |
| `gitlens.defaultGravatarsStyle` | Specifies the style of the gravatar default (fallback) images<br/><br/>`identicon` - a geometric pattern<br/>`mm` - 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` - a face with differing features and backgrounds |
| `gitlens.insiders` | Specifies whether to enable experimental features |
| `gitlens.keymap` | Specifies the keymap to use for GitLens shortcut keys<br/><br/>`alternate` - adds an alternate set of shortcut keys that start with `Alt` (⌥ on macOS)<br/>`chorded` - adds a chorded set of shortcut keys that start with `Ctrl+Shift+G` (<code>⌥⌘G</code> on macOS)<br/>`none` - no shortcut keys will be added |
| `gitlens.menus` | Specifies which commands will be added to which menus |
| `gitlens.outputLevel` | Specifies how much (if any) output will be sent to the GitLens output channel |
| `gitlens.settings.mode` | Specifies the display mode of the interactive settings editor<br/><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 |
| `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 side bar<br/>`explorer` - adds to the Explorer side bar<br/>`scm` - adds to the Source Control side bar |
| `gitlens.views.repositories.showTrackingBranch` | Specifies whether to show the tracking branch when displaying local branches in the _Repositories_ view |
| `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/><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. 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/><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. Only applies when `gitlens.views.repositories.files.layout` is set to `auto` |
| `gitlens.views.repositories.includeWorkingTree` | Specifies whether to include working tree file status for each repository in the _Repositories_ view |
| `gitlens.views.repositories.location` | Specifies where to show the _Repositories_ view<br/><br/>`gitlens` - adds to the GitLens side bar<br/>`explorer` - adds to the Explorer side bar<br/>`scm` - adds to the Source Control side bar |
| `gitlens.views.repositories.showTrackingBranch` | Specifies whether to show the tracking branch when displaying local branches in the _Repositories_ view |
### File History View Settings [#](#file-history-view-settings '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 side bar<br/>`explorer` - adds to the Explorer side bar<br/>`scm` - adds to the Source Control side bar |
| `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/><br/>`gitlens` - adds to the GitLens side bar<br/>`explorer` - adds to the Explorer side bar<br/>`scm` - adds to the Source Control side bar |
### Line History View Settings [#](#line-history-view-settings '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 side bar<br/>`explorer` - adds to the Explorer side bar<br/>`scm` - adds to the Source Control side bar |
| `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/><br/>`gitlens` - adds to the GitLens side bar<br/>`explorer` - adds to the Explorer side bar<br/>`scm` - adds to the Source Control side bar |
| `gitlens.views.compare.files.compact` | Specifies whether to compact (flatten) unnecessary file nesting in the _Compare_ view<br/>Only applies when `gitlens.views.compare.files.layout` is set to `tree` or `auto` |
| `gitlens.views.compare.enabled` | Specifies whether to show the _Compare_ view |
| `gitlens.views.compare.files.layout` | Specifies how the _Compare_ view will display files<br/>`auto` - automatically switches between displaying files as a `tree` or `list` based on the `gitlens.views.compare.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.compare.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 _Compare_ view<br/>Only applies when `gitlens.views.compare.files.layout` is set to `auto` |
| `gitlens.views.compare.location` | Specifies where to show the _Compare_ view<br/>`gitlens` - adds to the GitLens side bar<br/>`explorer` - adds to the Explorer side bar<br/>`scm` - adds to the Source Control side bar |
| `gitlens.views.compare.files.compact` | Specifies whether to compact (flatten) unnecessary file nesting in the _Compare_ view. Only applies when `gitlens.views.compare.files.layout` is set to `tree` or `auto` |
| `gitlens.views.compare.enabled` | Specifies whether to show the _Compare_ view |
| `gitlens.views.compare.files.layout` | Specifies how the _Compare_ view will display files<br/><br/>`auto` - automatically switches between displaying files as a `tree` or `list` based on the `gitlens.views.compare.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.compare.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 _Compare_ view. Only applies when `gitlens.views.compare.files.layout` is set to `auto` |
| `gitlens.views.compare.location` | Specifies where to show the _Compare_ view<br/><br/>`gitlens` - adds to the GitLens side bar<br/>`explorer` - adds to the Explorer side bar<br/>`scm` - adds to the Source Control side bar |
| `gitlens.views.avatars` | Specifies whether to show avatar images instead of commit (or status) icons in the views |
| `gitlens.views.commitFileFormat` | Specifies the format of a committed file in the 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 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`class="p"><class="nt">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 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 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 views<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 |
| `gitlens.views.avatars` | Specifies whether to show avatar images instead of commit (or status) icons in the views |
| `gitlens.views.commitFileFormat` | Specifies the format of a committed file in the views<br/><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 views. See the [GitLens docs](https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting) for advanced formatting<br/><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` |
| `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 views<br/><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 views. See the [GitLens docs](https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting) for advanced formatting<br/><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` |
| `gitlens.views.statusFileFormat` | Specifies the format of the status of a working or committed file in the views<br/><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 |
| `gitlens.codeLens.authors.command` | Specifies the command to be executed when the `authors` code lens is clicked<br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.diffWithPrevious` - compares the current committed file with the previous commit<br/>`gitlens.showQuickCommitDetails` - shows a commit details quick pick<br/>`gitlens.showQuickCommitFileDetails` - shows a commit file details quick pick<br/>`gitlens.showQuickFileHistory` - shows a file history quick pick<br/>`gitlens.showQuickRepoHistory` - shows a branch history quick pick |
| `gitlens.codeLens.authors.enabled` | Specifies whether to provide an `authors` code lens, showing number of authors of the file or code block and the most prominent author (if there is more than one) |
| `gitlens.codeLens.enabled` | Specifies whether to provide any Git code lens, by default<br/>Use the _Toggle Git Code Lens_ command (`gitlens.toggleCodeLens`) to toggle the Git code lens on and off for the current window |
| `gitlens.codeLens.includeSingleLineSymbols` | Specifies whether to provide any Git code lens on symbols that span only a single line |
| `gitlens.codeLens.recentChange.command` | Specifies the command to be executed when the `recent change` code lens is clicked<br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.diffWithPrevious` - compares the current committed file with the previous commit<br/>`gitlens.showQuickCommitDetails` - shows a commit details quick pick<br/>`gitlens.showQuickCommitFileDetails` - shows a commit file details quick pick<br/>`gitlens.showQuickFileHistory` - shows a file history quick pick<br/>`gitlens.showQuickRepoHistory` - shows a branch history quick pick |
| `gitlens.codeLens.recentChange.enabled` | Specifies whether to provide a `recent change` code lens, showing the author and date of the most recent commit for the file or code block |
| `gitlens.codeLens.scopes` | Specifies where Git code lens will be shown in the document<br/>`document` - adds code lens at the top of the document<br/>`containers` - adds code lens at the start of container-like symbols (modules, classes, interfaces, etc)<br/>`blocks` - adds code lens at the start of block-like symbols (functions, methods, etc) lines |
| `gitlens.codeLens.scopesByLanguage` | Specifies where Git code lens will be shown in the document for the specified languages |
| `gitlens.codeLens.symbolScopes` | Specifies a set of document symbols where Git code lens will or will not be shown in the document<br/>Prefix with `!` to avoid providing a Git code lens for the symbol<br/>Must be a member of [`SymbolKind`](https://code.visualstudio.com/docs/extensionAPI/vscode-api#_a-namesymbolkindaspan-classcodeitem-id660symbolkindspan) |
| `gitlens.codeLens.authors.command` | Specifies the command to be executed when an _authors_ code lens is clicked<br/><br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.diffWithPrevious` - compares the current committed file with the previous commit<br/>`gitlens.showQuickCommitDetails` - shows a commit details quick pick<br/>`gitlens.showQuickCommitFileDetails` - shows a commit file details quick pick<br/>`gitlens.showQuickFileHistory` - shows a file history quick pick<br/>`gitlens.showQuickRepoHistory` - shows a branch history quick pick |
| `gitlens.codeLens.authors.enabled` | Specifies whether to provide an _authors_ code lens, showing number of authors of the file or code block and the most prominent author (if there is more than one) |
| `gitlens.codeLens.enabled` | Specifies whether to provide any Git code lens, by default. Use the _Toggle Git Code Lens_ command (`gitlens.toggleCodeLens`) to toggle the Git code lens on and off for the current window |
| `gitlens.codeLens.includeSingleLineSymbols` | Specifies whether to provide any Git code lens on symbols that span only a single line |
| `gitlens.codeLens.recentChange.command` | Specifies the command to be executed when a _recent change_ code lens is clicked<br/><br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.diffWithPrevious` - compares the current committed file with the previous commit<br/>`gitlens.showQuickCommitDetails` - shows a commit details quick pick<br/>`gitlens.showQuickCommitFileDetails` - shows a commit file details quick pick<br/>`gitlens.showQuickFileHistory` - shows a file history quick pick<br/>`gitlens.showQuickRepoHistory` - shows a branch history quick pick |
| `gitlens.codeLens.recentChange.enabled` | Specifies whether to provide a _recent change_ code lens, showing the author and date of the most recent commit for the file or code block |
| `gitlens.codeLens.scopes` | Specifies where Git code lens will be shown in the document<br/><br/>`document` - adds code lens at the top of the document<br/>`containers` - adds code lens at the start of container-like symbols (modules, classes, interfaces, etc)<br/>`blocks` - adds code lens at the start of block-like symbols (functions, methods, etc) lines |
| `gitlens.codeLens.scopesByLanguage` | Specifies where Git code lens will be shown in the document for the specified languages |
| `gitlens.codeLens.symbolScopes` | Specifies a set of document symbols where Git code lens will or will not be shown in the document. Prefix with `!` to avoid providing a Git code lens for the symbol. Must be a member of [`SymbolKind`](https://code.visualstudio.com/docs/extensionAPI/vscode-api#_a-namesymbolkindaspan-classcodeitem-id660symbolkindspan) |
#### Current Line Blame Settings [#](#current-line-blame-settings 'Current Line Blame Settings')
| `gitlens.currentLine.dateFormat` | Specifies how to format absolute dates (using the `${date}` token) for the current line blame annotations<br/>See https://momentjs.com/docs/#/displaying/format/ for valid formats |
| `gitlens.currentLine.enabled` | Specifies whether to provide a blame annotation for the current line, by default<br/>Use the _Toggle Line Blame Annotations_ command (`gitlens.toggleLineBlame`) to toggle the annotations on and off for the current window |
| `gitlens.currentLine.format` | Specifies the format of the current line blame annotation<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.currentLine.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.currentLine.scrollable` | Specifies whether the current line blame annotation can be scrolled into view when it is outside the viewport |
| `gitlens.currentLine.dateFormat` | Specifies how to format absolute dates (using the `${date}` token) for the current line blame annotations. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats |
| `gitlens.currentLine.enabled` | Specifies whether to provide a blame annotation for the current line, by default. Use the _Toggle Line Blame Annotations_ command (`gitlens.toggleLineBlame`) to toggle the annotations on and off for the current window |
| `gitlens.currentLine.format` | Specifies the format of the current line blame annotation. See the [GitLens docs](https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting) for advanced formatting<br/><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.currentLine.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` |
| `gitlens.currentLine.scrollable` | Specifies whether the current line blame annotation can be scrolled into view when it is outside the viewport |
| `gitlens.blame.dateFormat` | Specifies how to format absolute dates (using the `${date}` token) in gutter blame annotations<br/>See https://momentjs.com/docs/#/displaying/format/ for valid formats |
| `gitlens.blame.format` | Specifies the format of the gutter blame annotations<br/>Available tokens<br/>`${id}` - commit id<br/>`${author}` - commit author<br/>`${message}` - commit message<br/>`${ago}` - relative commit date (e.g. 1 day ago)<br/>`${date}` - formatted commit date (format specified by `gitlens.blame.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.blame.heatmap.enabled` | Specifies whether to provide a heatmap indicator in the gutter blame annotations |
| `gitlens.blame.heatmap.location` | Specifies where the heatmap indicators will be shown in the gutter blame annotations<br/>`left` - adds a heatmap indicator on the left edge of the gutter blame annotations<br/>`right` - adds a heatmap indicator on the right edge of the gutter blame annotations |
| `gitlens.blame.highlight.enabled` | Specifies whether to highlight lines associated with the current line |
| `gitlens.blame.highlight.locations` | Specifies where the associated line highlights will be shown<br/>`gutter` - adds a gutter glyph<br/>`line` - adds a full-line highlight background color<br/>`overview` - adds a decoration to the overview ruler (scroll bar) |
| `gitlens.blame.ignoreWhitespace` | Specifies whether to ignore whitespace when comparing revisions during blame operations |
| `gitlens.blame.separateLines` | Specifies whether gutter blame annotations will have line separators |
| `gitlens.blame.toggleMode` | Specifies how the gutter blame annotations will be toggled<br/>`file` - toggles each file individually<br/>`window` - toggles the window, i.e. all files at once |
| `gitlens.blame.dateFormat` | Specifies how to format absolute dates (using the `${date}` token) in gutter blame annotations. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats |
| `gitlens.blame.format` | Specifies the format of the gutter blame annotations. See the [GitLens docs](https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting) for advanced formatting<br/><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.blame.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` |
| `gitlens.blame.heatmap.enabled` | Specifies whether to provide a heatmap indicator in the gutter blame annotations |
| `gitlens.blame.heatmap.location` | Specifies where the heatmap indicators will be shown in the gutter blame annotations<br/><br/>`left` - adds a heatmap indicator on the left edge of the gutter blame annotations<br/>`right` - adds a heatmap indicator on the right edge of the gutter blame annotations |
| `gitlens.blame.highlight.enabled` | Specifies whether to highlight lines associated with the current line |
| `gitlens.blame.highlight.locations` | Specifies where the associated line highlights will be shown<br/><br/>`gutter` - adds a gutter glyph<br/>`line` - adds a full-line highlight background color<br/>`overview` - adds a decoration to the overview ruler (scroll bar) |
| `gitlens.blame.ignoreWhitespace` | Specifies whether to ignore whitespace when comparing revisions during blame operations |
| `gitlens.blame.separateLines` | Specifies whether gutter blame annotations will have line separators |
| `gitlens.blame.toggleMode` | Specifies how the gutter blame annotations will be toggled<br/><br/>`file` - toggles each file individually<br/>`window` - toggles the window, i.e. all files at once |
@ -778,49 +778,49 @@ See also [View Settings](#view-settings 'Jump to the View settings')
| `gitlens.heatmap.ageThreshold` | Specifies the age of the most recent change (in days) after which the gutter heatmap annotations will be cold rather than hot (i.e. will use `gitlens.heatmap.coldColor` instead of `gitlens.heatmap.hotColor`) |
| `gitlens.heatmap.coldColor` | Specifies the base color of the gutter heatmap annotations when the most recent change is older (cold) than the `gitlens.heatmap.ageThreshold` value |
| `gitlens.heatmap.hotColor` | Specifies the base color of the gutter heatmap annotations when the most recent change is newer (hot) than the `gitlens.heatmap.ageThreshold` value |
| `gitlens.heatmap.toggleMode` | Specifies how the gutter heatmap annotations will be toggled<br/>`file` - toggles each file individually<br/>`window` - toggles the window, i.e. all files at once |
| `gitlens.heatmap.toggleMode` | Specifies how the gutter heatmap annotations will be toggled<br/><br/>`file` - toggles each file individually<br/>`window` - toggles the window, i.e. all files at once |
| `gitlens.hovers.annotations.changes` | Specifies whether to provide a changes (diff) hover for all lines when showing blame annotations |
| `gitlens.hovers.annotations.details` | Specifies whether to provide a commit details hover for all lines when showing blame annotations |
| `gitlens.hovers.annotations.enabled` | Specifies whether to provide any hovers when showing blame annotations |
| `gitlens.hovers.annotations.over` | Specifies when to trigger hovers when showing blame annotations<br/>`annotation` - only shown when hovering over the line annotation<br/>`line` - shown when hovering anywhere over the line |
| `gitlens.hovers.avatars` | Specifies whether to show avatar images in hovers |
| `gitlens.hovers.currentLine.changes` | Specifies whether to provide a changes (diff) hover for the current line |
| `gitlens.hovers.currentLine.details` | Specifies whether to provide a commit details hover for the current line |
| `gitlens.hovers.currentLine.enabled` | Specifies whether to provide any hovers for the current line |
| `gitlens.hovers.currentLine.over` | Specifies when to trigger hovers for the current line<br/>`annotation` - only shown when hovering over the line annotation<br/>`line` - shown when hovering anywhere over the line |
| `gitlens.hovers.enabled` | Specifies whether to provide any hovers |
| `gitlens.hovers.annotations.changes` | Specifies whether to provide a _changes (diff)_ hover for all lines when showing blame annotations |
| `gitlens.hovers.annotations.details` | Specifies whether to provide a _commit details_ hover for all lines when showing blame annotations |
| `gitlens.hovers.annotations.enabled` | Specifies whether to provide any hovers when showing blame annotations |
| `gitlens.hovers.annotations.over` | Specifies when to trigger hovers when showing blame annotations<br/><br/>`annotation` - only shown when hovering over the line annotation<br/>`line` - shown when hovering anywhere over the line |
| `gitlens.hovers.avatars` | Specifies whether to show avatar images in hovers |
| `gitlens.hovers.currentLine.changes` | Specifies whether to provide a _changes (diff)_ hover for the current line |
| `gitlens.hovers.currentLine.details` | Specifies whether to provide a _commit details_ hover for the current line |
| `gitlens.hovers.currentLine.enabled` | Specifies whether to provide any hovers for the current line |
| `gitlens.hovers.currentLine.over` | Specifies when to trigger hovers for the current line<br/><br/>`annotation` - only shown when hovering over the line annotation<br/>`line` - shown when hovering anywhere over the line |
| `gitlens.hovers.enabled` | Specifies whether to provide any hovers |
| `gitlens.mode.active` | Specifies the active GitLens mode, if any |
| `gitlens.mode.statusBar.enabled` | Specifies whether to provide the active GitLens mode in the status bar |
| `gitlens.mode.statusBar.alignment` | Specifies the active GitLens mode alignment in the status bar<br/>`left` - aligns to the left<br/>`right` - aligns to the right |
| `gitlens.modes` | Specifies the user-defined GitLens modes |
| `gitlens.mode.active` | Specifies the active GitLens mode, if any |
| `gitlens.mode.statusBar.enabled` | Specifies whether to provide the active GitLens mode in the status bar |
| `gitlens.mode.statusBar.alignment` | Specifies the active GitLens mode alignment in the status bar<br/><br/>`left` - aligns to the left<br/>`right` - aligns to the right |
| `gitlens.modes` | Specifies the user-defined GitLens modes |
| `gitlens.recentChanges.highlight.locations` | Specifies where the highlights of the recently changed lines will be shown<br/>`gutter` - adds a gutter glyph<br/>`line` - adds a full-line highlight background color<br/>`overview` - adds a decoration to the overview ruler (scroll bar) |
| `gitlens.recentChanges.toggleMode` | Specifies how the recently changed lines annotations will be toggled<br/>`file` - toggles each file individually<br/>`window` - toggles the window, i.e. all files at once |
| `gitlens.recentChanges.highlight.locations` | Specifies where the highlights of the recently changed lines will be shown<br/><br/>`gutter` - adds a gutter glyph<br/>`line` - adds a full-line highlight background color<br/>`overview` - adds a decoration to the overview ruler (scroll bar) |
| `gitlens.recentChanges.toggleMode` | Specifies how the recently changed lines annotations will be toggled<br/><br/>`file` - toggles each file individually<br/>`window` - toggles the window, i.e. all files at once |
### Status Bar Settings [#](#status-bar-settings 'Status Bar Settings')
| `gitlens.statusBar.alignment` | Specifies the blame alignment in the status bar<br/>`left` - aligns to the left<br/>`right` - aligns to the right |
| `gitlens.statusBar.command` | Specifies the command to be executed when the blame status bar item is clicked<br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.diffWithPrevious` - compares the current line commit with the previous<br/>`gitlens.diffWithWorking` - compares the current line commit with the working tree<br/>`gitlens.toggleCodeLens` - toggles Git code lens<br/>`gitlens.showQuickCommitDetails` - shows a commit details quick pick<br/>`gitlens.showQuickCommitFileDetails` - shows a commit file details quick pick<br/>`gitlens.showQuickFileHistory` - shows a file history quick pick<br/>`gitlens.showQuickRepoHistory` - shows a branch history quick pick |
| `gitlens.statusBar.dateFormat` | Specifies the date format of absolute dates shown in the blame information in the status bar<br/>See https://momentjs.com/docs/#/displaying/format/ for valid formats |
| `gitlens.statusBar.enabled` | Specifies whether to provide blame information in the status bar |
| `gitlens.statusBar.format` | Specifies the format of the blame information in the status bar<br/>Available tokens<br/>`${id}` - commit id<br/>`${author}` - commit author<br/>`${message}` - commit message<br/>`${ago}` - relative commit date (e.g. 1 day ago)<br/>`${date}` - formatted commit date (format specified by `gitlens.statusBar.dateFormat`)<br/>`${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.statusBar.reduceFlicker` | Specifies whether to avoid clearing the previous blame information when changing lines to reduce status bar "flashing" |
| `gitlens.statusBar.alignment` | Specifies the blame alignment in the status bar<br/><br/>`left` - aligns to the left<br/>`right` - aligns to the right |
| `gitlens.statusBar.command` | Specifies the command to be executed when the blame status bar item is clicked<br/><br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.diffWithPrevious` - compares the current line commit with the previous<br/>`gitlens.diffWithWorking` - compares the current line commit with the working tree<br/>`gitlens.toggleCodeLens` - toggles Git code lens<br/>`gitlens.showQuickCommitDetails` - shows a commit details quick pick<br/>`gitlens.showQuickCommitFileDetails` - shows a commit file details quick pick<br/>`gitlens.showQuickFileHistory` - shows a file history quick pick<br/>`gitlens.showQuickRepoHistory` - shows a branch history quick pick |
| `gitlens.statusBar.dateFormat` | Specifies the date format of absolute dates shown in the blame information in the status bar. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats |
| `gitlens.statusBar.enabled` | Specifies whether to provide blame information in the status bar |
| `gitlens.statusBar.format` | Specifies the format of the blame information in the status bar. See the [GitLens docs](https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting) for advanced formatting<br/><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` |
| `gitlens.statusBar.reduceFlicker` | Specifies whether to avoid clearing the previous blame information when changing lines to reduce status bar "flashing" |
| `gitlens.strings.codeLens.unsavedChanges.recentChangeAndAuthors` | Specifies the string to be shown in place of both the `recent change` and `authors` code lens when there are unsaved changes |
| `gitlens.strings.codeLens.unsavedChanges.recentChangeOnly` | Specifies the string to be shown in place of the `recent change` code lens when there are unsaved changes |
| `gitlens.strings.codeLens.unsavedChanges.authorsOnly` | Specifies the string to be shown in place of the `authors` code lens when there are unsaved changes |
| `gitlens.strings.codeLens.unsavedChanges.recentChangeAndAuthors` | Specifies the string to be shown in place of both the _recent change_ and _authors_ code lens when there are unsaved changes |
| `gitlens.strings.codeLens.unsavedChanges.recentChangeOnly` | Specifies the string to be shown in place of the _recent change_ code lens when there are unsaved changes |
| `gitlens.strings.codeLens.unsavedChanges.authorsOnly` | Specifies the string to be shown in place of the _authors_ code lens when there are unsaved changes |
"description":"Specifies whether to show avatar images in the gutter blame annotations",
"markdownDescription":"Specifies whether to show avatar images in the gutter blame annotations",
"scope":"window"
},
"gitlens.blame.compact":{
"type":"boolean",
"default":true,
"description":"Specifies whether to compact (deduplicate) matching adjacent gutter blame annotations",
"markdownDescription":"Specifies whether to compact (deduplicate) matching adjacent gutter blame annotations",
"scope":"window"
},
"gitlens.blame.dateFormat":{
"type":"string",
"default":null,
"description":"Specifies how to format absolute dates (using the `${date}` token) in gutter blame annotations\nSee https://momentjs.com/docs/#/displaying/format/ for valid formats",
"markdownDescription":"Specifies how to format absolute dates (using the `${date}` token) in gutter blame annotations. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats",
"scope":"window"
},
"gitlens.blame.format":{
"type":"string",
"default":"${message|40?} ${agoOrDate|14-}",
"description":"Specifies the format of the gutter blame annotations\nAvailable tokens\n ${id} - commit id\n ${author} - commit author\n ${message} - commit message\n ${ago} - relative commit date (e.g. 1 day ago)\n ${date} - formatted commit date (format specified by `gitlens.blame.dateFormat`)\n ${agoOrDate} - commit date specified by `gitlens.defaultDateStyle`\n ${authorAgo} - commit author, relative commit date\n ${authorAgoOrDate} - commit author, commit date specified by `gitlens.defaultDateStyle`\nSee https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting",
"markdownDescription":"Specifies the format of the gutter blame annotations. See the [GitLens docs](https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting) for advanced formatting\n- Available tokens\n - `${id}` — commit id\n - `${author}` — commit author\n - `${message}` — commit message\n - `${ago}` — relative commit date (e.g. 1 day ago)\n - `${date}` — formatted commit date (format specified by `#gitlens.blame.dateFormat#`)\n - `${agoOrDate}` — commit date specified by `#gitlens.defaultDateStyle#`\n - `${authorAgo}` — commit author, relative commit date\n - `${authorAgoOrDate}` — commit author, commit date specified by `#gitlens.defaultDateStyle#`",
"scope":"window"
},
"gitlens.blame.heatmap.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide a heatmap indicator in the gutter blame annotations",
"markdownDescription":"Specifies whether to provide a heatmap indicator in the gutter blame annotations",
"scope":"window"
},
"gitlens.blame.heatmap.location":{
@ -94,13 +94,13 @@
"Adds a heatmap indicator on the left edge of the gutter blame annotations",
"Adds a heatmap indicator on the right edge of the gutter blame annotations"
],
"description":"Specifies where the heatmap indicators will be shown in the gutter blame annotations",
"markdownDescription":"Specifies where the heatmap indicators will be shown in the gutter blame annotations",
"scope":"window"
},
"gitlens.blame.highlight.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to highlight lines associated with the current line",
"markdownDescription":"Specifies whether to highlight lines associated with the current line",
"scope":"window"
},
"gitlens.blame.highlight.locations":{
@ -126,19 +126,19 @@
"minItems":1,
"maxItems":3,
"uniqueItems":true,
"description":"Specifies where the associated line highlights will be shown",
"markdownDescription":"Specifies where the associated line highlights will be shown",
"scope":"window"
},
"gitlens.blame.ignoreWhitespace":{
"type":"boolean",
"default":false,
"description":"Specifies whether to ignore whitespace when comparing revisions during blame operations",
"markdownDescription":"Specifies whether to ignore whitespace when comparing revisions during blame operations",
"scope":"resource"
},
"gitlens.blame.separateLines":{
"type":"boolean",
"default":true,
"description":"Specifies whether gutter blame annotations will be separated by a small gap",
"markdownDescription":"Specifies whether gutter blame annotations will be separated by a small gap",
"scope":"window"
},
"gitlens.blame.toggleMode":{
@ -152,7 +152,7 @@
"Toggles each file individually",
"Toggles the window, i.e. all files at once"
],
"description":"Specifies how the gutter blame annotations will be toggled",
"markdownDescription":"Specifies how the gutter blame annotations will be toggled",
"scope":"window"
},
"gitlens.codeLens.authors.command":{
@ -174,25 +174,25 @@
"Shows a file history quick pick",
"Shows a branch history quick pick"
],
"description":"Specifies the command to be executed when the `authors` code lens is clicked",
"markdownDescription":"Specifies the command to be executed when an _authors_ code lens is clicked",
"scope":"window"
},
"gitlens.codeLens.authors.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide an `authors` code lens, showing number of authors of the file or code block and the most prominent author (if there is more than one)",
"markdownDescription":"Specifies whether to provide an _authors_ code lens, showing number of authors of the file or code block and the most prominent author (if there is more than one)",
"scope":"window"
},
"gitlens.codeLens.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide any Git code lens, by default\nUse the `Toggle Git Code Lens` command (`gitlens.toggleCodeLens`) to toggle the Git code lens on and off for the current window",
"markdownDescription":"Specifies whether to provide any Git code lens, by default. Use the `Toggle Git Code Lens` command (`gitlens.toggleCodeLens`) to toggle the Git code lens on and off for the current window",
"scope":"window"
},
"gitlens.codeLens.includeSingleLineSymbols":{
"type":"boolean",
"default":false,
"description":"Specifies whether to provide any Git code lens on symbols that span only a single line",
"markdownDescription":"Specifies whether to provide any Git code lens on symbols that span only a single line",
"scope":"window"
},
"gitlens.codeLens.recentChange.command":{
@ -214,13 +214,13 @@
"Shows a file history quick pick",
"Shows a branch history quick pick"
],
"description":"Specifies the command to be executed when the `recent change` code lens is clicked",
"markdownDescription":"Specifies the command to be executed when a _recent change_ code lens is clicked",
"scope":"window"
},
"gitlens.codeLens.recentChange.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide a `recent change` code lens, showing the author and date of the most recent commit for the file or code block",
"markdownDescription":"Specifies whether to provide a _recent change_ code lens, showing the author and date of the most recent commit for the file or code block",
"scope":"window"
},
"gitlens.codeLens.scopes":{
@ -245,7 +245,7 @@
"minItems":1,
"maxItems":4,
"uniqueItems":true,
"description":"Specifies where Git code lens will be shown in the document",
"markdownDescription":"Specifies where Git code lens will be shown in the document",
"scope":"resource"
},
"gitlens.codeLens.scopesByLanguage":{
@ -354,12 +354,12 @@
"type":"string"
},
"uniqueItems":true,
"description":"Specifies the set of document symbols where Git code lens will be shown in the document for the specified language\nMust be a member of `SymbolKind`"
"description":"Specifies the set of document symbols where Git code lens will be shown in the document for the specified language. Must be a member of `SymbolKind`"
}
}
},
"uniqueItems":true,
"description":"Specifies where Git code lens will be shown in the document for the specified languages",
"markdownDescription":"Specifies where Git code lens will be shown in the document for the specified languages",
"scope":"resource"
},
"gitlens.codeLens.symbolScopes":{
@ -368,43 +368,43 @@
"type":"string"
},
"uniqueItems":true,
"description":"Specifies a set of document symbols where Git code lens will or will not be shown in the document\nPrefix with `!` to avoid providing a Git code lens for the symbol\nMust be a member of `SymbolKind`",
"markdownDescription":"Specifies a set of document symbols where Git code lens will or will not be shown in the document. Prefix with `!` to avoid providing a Git code lens for the symbol. Must be a member of `SymbolKind`",
"scope":"resource"
},
"gitlens.currentLine.dateFormat":{
"type":"string",
"default":null,
"description":"Specifies how to format absolute dates (using the `${date}` token) for the current line blame annotation\nSee https://momentjs.com/docs/#/displaying/format/ for valid formats",
"markdownDescription":"Specifies how to format absolute dates (using the `${date}` token) for the current line blame annotation. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats",
"scope":"window"
},
"gitlens.currentLine.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide a blame annotation for the current line, by default\nUse the `Toggle Line Blame Annotations` command (`gitlens.toggleLineBlame`) to toggle the annotations on and off for the current window",
"markdownDescription":"Specifies whether to provide a blame annotation for the current line, by default. Use the `Toggle Line Blame Annotations` command (`gitlens.toggleLineBlame`) to toggle the annotations on and off for the current window",
"scope":"window"
},
"gitlens.currentLine.format":{
"type":"string",
"default":"${authorAgoOrDate} • ${message}",
"description":"Specifies the format of the current line blame annotation\nAvailable tokens\n ${id} - commit id\n ${author} - commit author\n ${message} - commit message\n ${ago} - relative commit date (e.g. 1 day ago)\n ${date} - formatted commit date (format specified by `gitlens.currentLine.dateFormat`)\n ${agoOrDate} - commit date specified by `gitlens.defaultDateStyle`\n ${authorAgo} - commit author, relative commit date\n ${authorAgoOrDate} - commit author, commit date specified by `gitlens.defaultDateStyle`\nSee https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting",
"markdownDescription":"Specifies the format of the current line blame annotation. See the [GitLens docs](https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting) for advanced formatting\n- Available tokens\n - `${id}` — commit id\n - `${author}` — commit author\n - `${message}` — commit message\n - `${ago}` — relative commit date (e.g. 1 day ago)\n - `${date}` — formatted commit date (format specified by `#gitlens.currentLine.dateFormat#`)\n - `${agoOrDate}` — commit date specified by `#gitlens.defaultDateStyle#`\n - `${authorAgo}` — commit author, relative commit date\n - `${authorAgoOrDate}` — commit author, commit date specified by `#gitlens.defaultDateStyle#`",
"scope":"window"
},
"gitlens.currentLine.scrollable":{
"type":"boolean",
"default":true,
"description":"Specifies whether the current line blame annotation can be scrolled into view when it is outside the viewport",
"markdownDescription":"Specifies whether the current line blame annotation can be scrolled into view when it is outside the viewport",
"scope":"window"
},
"gitlens.debug":{
"type":"boolean",
"default":false,
"description":"Specifies debug mode",
"markdownDescription":"Specifies debug mode",
"scope":"window"
},
"gitlens.defaultDateFormat":{
"type":"string",
"default":null,
"description":"Specifies how absolute dates will be formatted by default\nSee https://momentjs.com/docs/#/displaying/format/ for valid formats",
"markdownDescription":"Specifies how absolute dates will be formatted by default. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats",
"scope":"window"
},
"gitlens.defaultDateStyle":{
@ -418,7 +418,7 @@
"e.g. 1 day ago",
"e.g. July 25th, 2018 7:18pm"
],
"description":"Specifies how dates will be displayed by default",
"markdownDescription":"Specifies how dates will be displayed by default",
"scope":"window"
},
"gitlens.defaultGravatarsStyle":{
@ -440,25 +440,25 @@
"A robot with different colors, faces, etc",
"A face with differing features and backgrounds"
],
"description":"Specifies the style of the gravatar default (fallback) images",
"markdownDescription":"Specifies the style of the gravatar default (fallback) images",
"scope":"window"
},
"gitlens.heatmap.ageThreshold":{
"type":"string",
"default":"90",
"description":"Specifies the age of the most recent change (in days) after which the gutter heatmap annotations will be cold rather than hot (i.e. will use `#gitlens.heatmap.coldColor#` instead of `#gitlens.heatmap.hotColor#`)",
"markdownDescription":"Specifies the age of the most recent change (in days) after which the gutter heatmap annotations will be cold rather than hot (i.e. will use `#gitlens.heatmap.coldColor#` instead of `#gitlens.heatmap.hotColor#`)",
"scope":"window"
},
"gitlens.heatmap.coldColor":{
"type":"string",
"default":"#0a60f6",
"description":"Specifies the base color of the gutter heatmap annotations when the most recent change is older (cold) than the `#gitlens.heatmap.ageThreshold#` value",
"markdownDescription":"Specifies the base color of the gutter heatmap annotations when the most recent change is older (cold) than the `#gitlens.heatmap.ageThreshold#` value",
"scope":"window"
},
"gitlens.heatmap.hotColor":{
"type":"string",
"default":"#f66a0a",
"description":"Specifies the base color of the gutter heatmap annotations when the most recent change is newer (hot) than the `#gitlens.heatmap.ageThreshold#` value",
"markdownDescription":"Specifies the base color of the gutter heatmap annotations when the most recent change is newer (hot) than the `#gitlens.heatmap.ageThreshold#` value",
"scope":"window"
},
"gitlens.heatmap.toggleMode":{
@ -472,25 +472,25 @@
"Toggles each file individually",
"Toggles the window, i.e. all files at once"
],
"description":"Specifies how the gutter heatmap annotations will be toggled",
"markdownDescription":"Specifies how the gutter heatmap annotations will be toggled",
"scope":"window"
},
"gitlens.hovers.annotations.changes":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide a changes (diff) hover for all lines when showing blame annotations",
"markdownDescription":"Specifies whether to provide a _changes (diff)_ hover for all lines when showing blame annotations",
"scope":"window"
},
"gitlens.hovers.annotations.details":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide a commit details hover for all lines when showing blame annotations",
"markdownDescription":"Specifies whether to provide a _commit details_ hover for all lines when showing blame annotations",
"scope":"window"
},
"gitlens.hovers.annotations.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide any hovers when showing blame annotations",
"markdownDescription":"Specifies whether to provide any hovers when showing blame annotations",
"scope":"window"
},
"gitlens.hovers.annotations.over":{
@ -504,25 +504,25 @@
"Only shown when hovering over the line annotation",
"Shown when hovering anywhere over the line"
],
"description":"Specifies when to trigger hovers when showing blame annotations",
"markdownDescription":"Specifies when to trigger hovers when showing blame annotations",
"scope":"window"
},
"gitlens.hovers.currentLine.changes":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide a changes (diff) hover for the current line",
"markdownDescription":"Specifies whether to provide a _changes (diff)_ hover for the current line",
"scope":"window"
},
"gitlens.hovers.currentLine.details":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide a commit details hover for the current line",
"markdownDescription":"Specifies whether to provide a _commit details_ hover for the current line",
"scope":"window"
},
"gitlens.hovers.currentLine.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide any hovers for the current line",
"markdownDescription":"Specifies whether to provide any hovers for the current line",
"scope":"window"
},
"gitlens.hovers.currentLine.over":{
@ -536,25 +536,25 @@
"Only shown when hovering over the line annotation",
"Shown when hovering anywhere over the line"
],
"description":"Specifies when to trigger hovers for the current line",
"markdownDescription":"Specifies when to trigger hovers for the current line",
"scope":"window"
},
"gitlens.hovers.avatars":{
"type":"boolean",
"default":true,
"description":"Specifies whether to show avatar images in hovers",
"markdownDescription":"Specifies whether to show avatar images in hovers",
"scope":"window"
},
"gitlens.hovers.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide any hovers",
"markdownDescription":"Specifies whether to provide any hovers",
"scope":"window"
},
"gitlens.insiders":{
"type":"boolean",
"default":false,
"description":"Specifies whether to enable experimental features",
"markdownDescription":"Specifies whether to enable experimental features",
"scope":"window"
},
"gitlens.keymap":{
@ -570,7 +570,7 @@
"Adds a chorded set of shortcut keys that start with `Ctrl+Alt+G` (`⌥⌘G` on macOS)",
"No shortcut keys will be added"
],
"description":"Specifies the keymap to use for GitLens shortcut keys",
"markdownDescription":"Specifies the keymap to use for GitLens shortcut keys",
"scope":"window"
},
"gitlens.menus":{
@ -716,18 +716,18 @@
"remote":true
}
},
"description":"Specifies which commands will be added to which menus",
"markdownDescription":"Specifies which commands will be added to which menus",
"scope":"window"
},
"gitlens.mode.active":{
"type":"string",
"description":"Specifies the active GitLens mode, if any",
"markdownDescription":"Specifies the active GitLens mode, if any",
"scope":"window"
},
"gitlens.mode.statusBar.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide the active GitLens mode in the status bar",
"markdownDescription":"Specifies whether to provide the active GitLens mode in the status bar",
"scope":"window"
},
"gitlens.mode.statusBar.alignment":{
@ -741,7 +741,7 @@
"Aligns to the left",
"Aligns to the right"
],
"description":"Specifies the active GitLens mode alignment in the status bar",
"markdownDescription":"Specifies the active GitLens mode alignment in the status bar",
"scope":"window"
},
"gitlens.modes":{
@ -863,7 +863,7 @@
"hovers":true
}
},
"description":"Specifies the user-defined GitLens modes",
"markdownDescription":"Specifies the user-defined GitLens modes",
"scope":"window"
},
"gitlens.outputLevel":{
@ -875,7 +875,7 @@
"verbose",
"debug"
],
"description":"Specifies how much (if any) output will be sent to the GitLens output channel",
"markdownDescription":"Specifies how much (if any) output will be sent to the GitLens output channel",
"scope":"window"
},
"gitlens.recentChanges.highlight.locations":{
@ -901,7 +901,7 @@
"minItems":1,
"maxItems":3,
"uniqueItems":true,
"description":"Specifies where the highlights of the recently changed lines will be shown",
"markdownDescription":"Specifies where the highlights of the recently changed lines will be shown",
"scope":"window"
},
"gitlens.recentChanges.toggleMode":{
@ -915,7 +915,7 @@
"Toggles each file individually",
"Toggles the window, i.e. all files at once"
],
"description":"Specifies how the recently changed lines annotations will be toggled",
"markdownDescription":"Specifies how the recently changed lines annotations will be toggled",
"scope":"window"
},
"gitlens.remotes":{
@ -968,39 +968,39 @@
"properties":{
"repository":{
"type":"string",
"description":"Specifies the format of a respository url for the custom remote service\nAvailable tokens\n ${repo} - repository path"
"description":"Specifies the format of a respository url for the custom remote service\nAvailable tokens\n ${repo}` — repository path"
},
"branches":{
"type":"string",
"description":"Specifies the format of a branches url for the custom remote service\nAvailable tokens\n ${repo} - repository path\n ${branch} - branch"
"description":"Specifies the format of a branches url for the custom remote service\nAvailable tokens\n ${repo}` — repository path\n ${branch}` — branch"
},
"branch":{
"type":"string",
"description":"Specifies the format of a branch url for the custom remote service\nAvailable tokens\n ${repo} - repository path\n ${branch} - branch"
"description":"Specifies the format of a branch url for the custom remote service\nAvailable tokens\n ${repo}` — repository path\n ${branch}` — branch"
},
"commit":{
"type":"string",
"description":"Specifies the format of a commit url for the custom remote service\nAvailable tokens\n ${repo} - repository path\n ${id} - commit id"
"description":"Specifies the format of a commit url for the custom remote service\nAvailable tokens\n ${repo}` — repository path\n ${id}` — commit id"
},
"file":{
"type":"string",
"description":"Specifies the format of a file url for the custom remote service\nAvailable tokens\n ${repo} - repository path\n ${file} - file name\n ${line} - formatted line information"
"description":"Specifies the format of a file url for the custom remote service\nAvailable tokens\n ${repo}` — repository path\n ${file}` — file name\n ${line}` — formatted line information"
},
"fileInBranch":{
"type":"string",
"description":"Specifies the format of a branch file url for the custom remote service\nAvailable tokens\n ${repo} - repository path\n ${file} - file name\n ${branch} - branch\n ${line} - formatted line information"
"description":"Specifies the format of a branch file url for the custom remote service\nAvailable tokens\n ${repo}` — repository path\n ${file}` — file name\n ${branch}` — branch\n ${line}` — formatted line information"
},
"fileInCommit":{
"type":"string",
"description":"Specifies the format of a commit file url for the custom remote service\nAvailable tokens\n ${repo} - repository path\n ${file} - file name\n ${id} - commit id\n ${line} - formatted line information"
"description":"Specifies the format of a commit file url for the custom remote service\nAvailable tokens\n ${repo}` — repository path\n ${file}` — file name\n ${id}` — commit id\n ${line}` — formatted line information"
},
"fileLine":{
"type":"string",
"description":"Specifies the format of a line in a file url for the custom remote service\nAvailable tokens\n ${line} - line"
"description":"Specifies the format of a line in a file url for the custom remote service\nAvailable tokens\n ${line}` — line"
},
"fileRange":{
"type":"string",
"description":"Specifies the format of a range in a file url for the custom remote service\nAvailable tokens\n ${start} - starting line\n ${end} - ending line"
"description":"Specifies the format of a range in a file url for the custom remote service\nAvailable tokens\n ${start}` — starting line\n ${end}` — ending line"
}
}
},
@ -1008,7 +1008,7 @@
}
},
"uniqueItems":true,
"description":"Specifies user-defined remote (code-hosting) services or custom domains for built-in remote services",
"markdownDescription":"Specifies user-defined remote (code-hosting) services or custom domains for built-in remote services",
"scope":"resource"
},
"gitlens.settings.mode":{
@ -1022,13 +1022,13 @@
"Only displays common settings",
"Displays all settings"
],
"description":"Specifies the display mode of the interactive settings editor",
"markdownDescription":"Specifies the display mode of the interactive settings editor",
"scope":"window"
},
"gitlens.showWhatsNewAfterUpgrades":{
"type":"boolean",
"default":true,
"description":"Specifies whether to show What's New after upgrading to new feature releases",
"markdownDescription":"Specifies whether to show What's New after upgrading to new feature releases",
"scope":"window"
},
"gitlens.statusBar.alignment":{
@ -1042,7 +1042,7 @@
"Aligns to the left",
"Aligns to the right"
],
"description":"Specifies the blame alignment in the status bar",
"markdownDescription":"Specifies the blame alignment in the status bar",
"scope":"window"
},
"gitlens.statusBar.command":{
@ -1068,79 +1068,79 @@
"Shows a file history quick pick",
"Shows a branch history quick pick"
],
"description":"Specifies the command to be executed when the blame status bar item is clicked",
"markdownDescription":"Specifies the command to be executed when the blame status bar item is clicked",
"scope":"window"
},
"gitlens.statusBar.dateFormat":{
"type":"string",
"default":null,
"description":"Specifies the date format of absolute dates shown in the blame information in the status bar. See https://momentjs.com/docs/#/displaying/format/ for valid formats",
"markdownDescription":"Specifies the date format of absolute dates shown in the blame information in the status bar. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats",
"scope":"window"
},
"gitlens.statusBar.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to provide blame information in the status bar",
"markdownDescription":"Specifies whether to provide blame information in the status bar",
"scope":"window"
},
"gitlens.statusBar.format":{
"type":"string",
"default":"${authorAgoOrDate}",
"description":"Specifies the format of the status bar blame information\nAvailable tokens\n ${id} - commit id\n ${author} - commit author\n ${message} - commit message\n ${ago} - relative commit date (e.g. 1 day ago)\n ${date} - formatted commit date (format specified by `gitlens.statusBar.dateFormat`)\n ${agoOrDate} - commit date specified by `gitlens.defaultDateStyle`\n ${authorAgo} - commit author, relative commit date\n ${authorAgoOrDate} - commit author, commit date specified by `gitlens.defaultDateStyle`\nSee https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting",
"markdownDescription":"Specifies the format of the gutter blame annotations. See the [GitLens docs](https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting) for advanced formatting\n- Available tokens\n - `${id}` — commit id\n - `${author}` — commit author\n - `${message}` — commit message\n - `${ago}` — relative commit date (e.g. 1 day ago)\n - `${date}` — formatted commit date (format specified by `#gitlens.statusBar.dateFormat#`)\n - `${agoOrDate}` — commit date specified by `#gitlens.defaultDateStyle#`\n - `${authorAgo}` — commit author, relative commit date\n - `${authorAgoOrDate}` — commit author, commit date specified by `#gitlens.defaultDateStyle#`",
"scope":"window"
},
"gitlens.statusBar.reduceFlicker":{
"type":"boolean",
"default":false,
"description":"Specifies whether to avoid clearing the previous blame information when changing lines to reduce status bar \"flashing\"",
"markdownDescription":"Specifies whether to avoid clearing the previous blame information when changing lines to reduce status bar \"flashing\"",
"description":"Specifies the string to be shown in place of the `authors` code lens when there are unsaved changes",
"markdownDescription":"Specifies the string to be shown in place of the _authors_ code lens when there are unsaved changes",
"scope":"window"
},
"gitlens.views.avatars":{
"type":"boolean",
"default":true,
"description":"Specifies whether to show avatar images instead of commit (or status) icons in the views",
"markdownDescription":"Specifies whether to show avatar images instead of commit (or status) icons in the views",
"scope":"window"
},
"gitlens.views.commitFileFormat":{
"type":"string",
"default":"${filePath}",
"description":"Specifies the format of a committed file in the views\nAvailable tokens\n ${directory} - directory name\n ${file} - file name\n ${filePath} - formatted file name and path\n ${path} - full file path",
"markdownDescription":"Specifies the format of a committed file in the views\n- Available tokens\n - `${directory}` — directory name\n - `${file}` — file name\n - `${filePath}` — formatted file name and path\n - `${path}` — full file path",
"description":"Specifies the format of committed changes in the views\nAvailable tokens\n ${id} - commit id\n ${author} - commit author\n ${message} - commit message\n ${ago} - relative commit date (e.g. 1 day ago)\n ${date} - formatted commit date (format specified by `gitlens.defaultDateFormat`)\\n ${agoOrDate} - commit date specified by `gitlens.defaultDateStyle`\n ${authorAgo} - commit author, relative commit date\n ${authorAgoOrDate} - commit author, commit date specified by `gitlens.defaultDateStyle`\nSee https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting",
"markdownDescription":"Specifies the format of committed changes in the views. See the [GitLens docs](https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting) for advanced formatting\n- Available tokens\n - `${id}` — commit id\n - `${author}` — commit author\n - `${message}` — commit message\n - `${ago}` — relative commit date (e.g. 1 day ago)\n - `${date}` — formatted commit date (format specified by `#gitlens.defaultDateFormat#`)\n - `${agoOrDate}` — commit date specified by `#gitlens.defaultDateStyle#`\n - `${authorAgo}` — commit author, relative commit date\n - `${authorAgoOrDate}` — commit author, commit date specified by `#gitlens.defaultDateStyle#`",
"scope":"window"
},
"gitlens.views.compare.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to show the `Compare` view",
"markdownDescription":"Specifies whether to show the _Compare_ view",
"scope":"window"
},
"gitlens.views.compare.files.compact":{
"type":"boolean",
"default":true,
"description":"Specifies whether to compact (flatten) unnecessary file nesting in the `Compare` view\nOnly applies when `#gitlens.views.compare.files.layout#` is set to `tree` or `auto`",
"markdownDescription":"Specifies whether to compact (flatten) unnecessary file nesting in the _Compare_ view. Only applies when `#gitlens.views.compare.files.layout#` is set to `tree` or `auto`",
"scope":"window"
},
"gitlens.views.compare.files.layout":{
@ -1156,13 +1156,13 @@
"Displays files as a list",
"Displays files as a tree"
],
"description":"Specifies how the `Compare` view will display files",
"markdownDescription":"Specifies how the _Compare_ view will display files",
"scope":"window"
},
"gitlens.views.compare.files.threshold":{
"type":"number",
"default":5,
"description":"Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the `Compare` view\nOnly applies when `#gitlens.views.compare.files.layout#` is set to `auto`",
"markdownDescription":"Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Compare_ view. Only applies when `#gitlens.views.compare.files.layout#` is set to `auto`",
"scope":"window"
},
"gitlens.views.compare.location":{
@ -1178,25 +1178,25 @@
"Adds to the Explorer side bar",
"Adds to the Source Control side bar"
],
"description":"Specifies where to show the `Compare` view",
"markdownDescription":"Specifies where to show the _Compare_ view",
"scope":"window"
},
"gitlens.views.defaultItemLimit":{
"type":"number",
"default":10,
"description":"Specifies the default number of items to show in a view list. Use 0 to specify no limit",
"markdownDescription":"Specifies the default number of items to show in a view list. Use 0 to specify no limit",
"scope":"window"
},
"gitlens.views.fileHistory.avatars":{
"type":"boolean",
"default":true,
"description":"Specifies whether to show avatar images instead of status icons in the `File History` view",
"markdownDescription":"Specifies whether to show avatar images instead of status icons in the _File History_ view",
"scope":"window"
},
"gitlens.views.fileHistory.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to show the `File History` view",
"markdownDescription":"Specifies whether to show the _File History_ view",
"scope":"window"
},
"gitlens.views.fileHistory.location":{
@ -1212,19 +1212,19 @@
"Adds to the Explorer side bar",
"Adds to the Source Control side bar"
],
"description":"Specifies where to show the `File History` view",
"markdownDescription":"Specifies where to show the _File History_ view",
"scope":"window"
},
"gitlens.views.lineHistory.avatars":{
"type":"boolean",
"default":true,
"description":"Specifies whether to show avatar images instead of status icons in the `Line History` view",
"markdownDescription":"Specifies whether to show avatar images instead of status icons in the _Line History_ view",
"scope":"window"
},
"gitlens.views.lineHistory.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to show the `Line History` view",
"markdownDescription":"Specifies whether to show the _Line History_ view",
"scope":"window"
},
"gitlens.views.lineHistory.location":{
@ -1240,19 +1240,19 @@
"Adds to the Explorer side bar",
"Adds to the Source Control side bar"
],
"description":"Specifies where to show the `Line History` view",
"markdownDescription":"Specifies where to show the _Line History_ view",
"scope":"window"
},
"gitlens.views.repositories.autoRefresh":{
"type":"boolean",
"default":true,
"description":"Specifies whether to automatically refresh the `Repositories` view when the repository or the file system changes",
"markdownDescription":"Specifies whether to automatically refresh the _Repositories_ view when the repository or the file system changes",
"scope":"window"
},
"gitlens.views.repositories.autoReveal":{
"type":"boolean",
"default":true,
"description":"Specifies whether to automatically reveal repositories in the `Repositories` view when opening files",
"markdownDescription":"Specifies whether to automatically reveal repositories in the _Repositories_ view when opening files",
"scope":"window"
},
"gitlens.views.repositories.branches.layout":{
@ -1266,19 +1266,19 @@
"Displays branches as a list",
"Displays branches as a tree when branch names contain slashes `/`"
],
"description":"Specifies how the `Repositories` view will display branches",
"markdownDescription":"Specifies how the _Repositories_ view will display branches",
"scope":"window"
},
"gitlens.views.repositories.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to show the `Repositories` view",
"markdownDescription":"Specifies whether to show the _Repositories_ view",
"scope":"window"
},
"gitlens.views.repositories.files.compact":{
"type":"boolean",
"default":true,
"description":"Specifies whether to compact (flatten) unnecessary file nesting in the `Repositories` view\nOnly applies when `#gitlens.views.repositories.files.layout#` is set to `tree` or `auto`",
"markdownDescription":"Specifies whether to compact (flatten) unnecessary file nesting in the _Repositories_ view. Only applies when `#gitlens.views.repositories.files.layout#` is set to `tree` or `auto`",
"scope":"window"
},
"gitlens.views.repositories.files.layout":{
@ -1294,19 +1294,19 @@
"Displays files as a list",
"Displays files as a tree"
],
"description":"Specifies how the `Repositories` view will display files",
"markdownDescription":"Specifies how the _Repositories_ view will display files",
"scope":"window"
},
"gitlens.views.repositories.files.threshold":{
"type":"number",
"default":5,
"description":"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\nOnly applies when `#gitlens.views.repositories.files.layout#` is set to `auto`",
"markdownDescription":"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. Only applies when `#gitlens.views.repositories.files.layout#` is set to `auto`",
"scope":"window"
},
"gitlens.views.repositories.includeWorkingTree":{
"type":"boolean",
"default":true,
"description":"Specifies whether to include working tree files inside the `Repository` node of the `Repositories` view",
"markdownDescription":"Specifies whether to include working tree file status for each repository in the _Repositories_ view",
"scope":"window"
},
"gitlens.views.repositories.location":{
@ -1322,25 +1322,25 @@
"Adds to the Explorer side bar",
"Adds to the Source Control side bar"
],
"description":"Specifies where to show the `Repositories` view",
"markdownDescription":"Specifies where to show the _Repositories_ view",
"scope":"window"
},
"gitlens.views.repositories.showTrackingBranch":{
"type":"boolean",
"default":true,
"description":"Specifies whether to show the tracking branch when displaying local branches in the `Repositories` view",
"markdownDescription":"Specifies whether to show the tracking branch when displaying local branches in the _Repositories_ view",
"scope":"window"
},
"gitlens.views.search.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to show the `Search Commits` view",
"markdownDescription":"Specifies whether to show the _Search Commits_ view",
"scope":"window"
},
"gitlens.views.search.files.compact":{
"type":"boolean",
"default":true,
"description":"Specifies whether to compact (flatten) unnecessary file nesting in the `Search Commits` view\nOnly applies when `#gitlens.views.search.files.layout#` is set to `tree` or `auto`",
"markdownDescription":"Specifies whether to compact (flatten) unnecessary file nesting in the _Search Commits_ view. Only applies when `#gitlens.views.search.files.layout#` is set to `tree` or `auto`",
"scope":"window"
},
"gitlens.views.search.files.layout":{
@ -1356,13 +1356,13 @@
"Displays files as a list",
"Displays files as a tree"
],
"description":"Specifies how the `Search Commits` view will display files",
"markdownDescription":"Specifies how the _Search Commits_ view will display files",
"scope":"window"
},
"gitlens.views.search.files.threshold":{
"type":"number",
"default":5,
"description":"Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the `Search Commits` view\nOnly applies when `#gitlens.views.search.files.layout#` is set to `auto`",
"markdownDescription":"Specifies when to switch between displaying files as a `tree` or `list` based on the number of files in a nesting level in the _Search Commits_ view. Only applies when `#gitlens.views.search.files.layout#` is set to `auto`",
"scope":"window"
},
"gitlens.views.search.location":{
@ -1378,25 +1378,25 @@
"Adds to the Explorer side bar",
"Adds to the Source Control side bar"
],
"description":"Specifies where to show the `Search Commits` view",
"markdownDescription":"Specifies where to show the _Search Commits_ view",
"scope":"window"
},
"gitlens.views.stashFileFormat":{
"type":"string",
"default":"${filePath}",
"description":"Specifies the format of a stashed file in the views\nAvailable tokens\n ${directory} - directory name\n ${file} - file name\n ${filePath} - formatted file name and path\n ${path} - full file path",
"markdownDescription":"Specifies the format of a stashed file in the views\n- Available tokens\n - `${directory}` — directory name\n - `${file}` — file name\n - `${filePath}` — formatted file name and path\n - `${path}` — full file path",
"scope":"window"
},
"gitlens.views.stashFormat":{
"type":"string",
"default":"${message}",
"description":"Specifies the format of stashed changes in the views\nAvailable tokens\n ${id} - commit id\n ${author} - commit author\n ${message} - commit message\n ${ago} - relative commit date (e.g. 1 day ago)\n ${date} - formatted commit date (format specified by `gitlens.statusBar.dateFormat`)\n ${agoOrDate} - commit date specified by `gitlens.defaultDateStyle`\n ${authorAgo} - commit author, relative commit date\n ${authorAgoOrDate} - commit author, commit date specified by `gitlens.defaultDateStyle`\nSee https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting for advanced formatting",
"markdownDescription":"Specifies the format of stashed changes in the views. See the [GitLens docs](https://github.com/eamodio/vscode-gitlens/wiki/Advanced-Formatting) for advanced formatting\n- Available tokens\n - `${id}` — commit id\n - `${author}` — commit author\n - `${message}` — commit message\n - `${ago}` — relative commit date (e.g. 1 day ago)\n - `${date}` — formatted commit date (format specified by `#gitlens.statusBar.dateFormat#`)\n - `${agoOrDate}` — commit date specified by `#gitlens.defaultDateStyle#`\n - `${authorAgo}` — commit author, relative commit date\n - `${authorAgoOrDate}` — commit author, commit date specified by `#gitlens.defaultDateStyle#`",
"scope":"window"
},
"gitlens.views.statusFileFormat":{
"type":"string",
"default":"${working }${filePath}",
"description":"Specifies the format of the status of a working or committed file in the views\nAvailable tokens\n ${directory} - directory name\n ${file} - file name\n ${filePath} - formatted file name and path\n ${path} - full file path\n ${working} - optional indicator if the file is uncommitted",
"markdownDescription":"Specifies the format of the status of a working or committed file in the views\n- Available tokens\n - `${directory}` — directory name\n - `${file}` — file name\n - `${filePath}` — formatted file name and path\n - `${path}` — full file path\n - `${working}` — optional indicator if the file is uncommitted",
"scope":"window"
},
"gitlens.advanced.blame.customArguments":{
@ -1405,37 +1405,37 @@
"items":{
"type":"string"
},
"description":"Specifies additional arguments to pass to the `git blame` command",
"markdownDescription":"Specifies additional arguments to pass to the `git blame` command",
"scope":"resource"
},
"gitlens.advanced.blame.delayAfterEdit":{
"type":"number",
"default":5000,
"description":"Specifies the time (in milliseconds) to wait before re-blaming an unsaved document after an edit. Use 0 to specify an infinite wait",
"markdownDescription":"Specifies the time (in milliseconds) to wait before re-blaming an unsaved document after an edit. Use 0 to specify an infinite wait",
"scope":"window"
},
"gitlens.advanced.blame.sizeThresholdAfterEdit":{
"type":"number",
"default":5000,
"description":"Specifies the maximum document size (in lines) allowed to be re-blamed after an edit while still unsaved. Use 0 to specify no maximum",
"markdownDescription":"Specifies the maximum document size (in lines) allowed to be re-blamed after an edit while still unsaved. Use 0 to specify no maximum",
"scope":"window"
},
"gitlens.advanced.caching.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether git output will be cached — changing the default is not recommended",
"markdownDescription":"Specifies whether git output will be cached — changing the default is not recommended",
"scope":"window"
},
"gitlens.advanced.fileHistoryFollowsRenames":{
"type":"boolean",
"default":true,
"description":"Specifies whether file histories will follow renames — will affect how merge commits are shown in histories",
"markdownDescription":"Specifies whether file histories will follow renames — will affect how merge commits are shown in histories",
"scope":"window"
},
"gitlens.advanced.maxListItems":{
"type":"number",
"default":200,
"description":"Specifies the maximum number of items to show in a list. Use 0 to specify no maximum",
"markdownDescription":"Specifies the maximum number of items to show in a list. Use 0 to specify no maximum",
"scope":"window"
},
"gitlens.advanced.messages":{
@ -1489,25 +1489,25 @@
"default":false
}
},
"description":"Specifies which messages should be suppressed",
"markdownDescription":"Specifies which messages should be suppressed",
"scope":"window"
},
"gitlens.advanced.quickPick.closeOnFocusOut":{
"type":"boolean",
"default":true,
"description":"Specifies whether to close QuickPick menus when focus is lost",
"markdownDescription":"Specifies whether to close QuickPick menus when focus is lost",
"scope":"window"
},
"gitlens.advanced.repositorySearchDepth":{
"type":"number",
"default":1,
"description":"Specifies how many folders deep to search for repositories",
"markdownDescription":"Specifies how many folders deep to search for repositories",
"scope":"resource"
},
"gitlens.advanced.telemetry.enabled":{
"type":"boolean",
"default":true,
"description":"Specifies whether to enable GitLens telemetry (even if enabled still abides by the overall `telemetry.enableTelemetry` setting",
"markdownDescription":"Specifies whether to enable GitLens telemetry (even if enabled still abides by the overall `#telemetry.enableTelemetry#` setting",
Eric Amodio
6 years ago