@ -265,8 +265,8 @@ The _Commits_ view lists all of the commits on the current branch, and additiona
- the current branch status — shows the upstream status of the current branch
- **Publish <current branch> to <remote>**— shown when the current branch has not been published to a remote
- **Up to date with <remote>**— shown when the current branch is up to date with the upstream remote
- **Changes to push to <remote>**— lists of all the files changed in the unpublished commits when the current branch has (unpublished) commits that waiting to be pushed to the upstream remote
- **Changes to pull from <remote>**— lists all of the commits waiting to be pulled when the current branch has commits that are waiting to be pulled from the upstream remote
- **Changes to push to <remote>**— lists of all the files changed in the unpublished commits when the current branch has (unpublished) commits that waiting to be pushed to the upstream remote
- any associated pull request — shows any opened pull request associated with the current branch
---
@ -289,23 +289,24 @@ The Repositories view lists opened Git repositories, and additionally provides,
- _Red dot_— has changes un-pulled (behind)
- _Yellow dot_— both unpublished and un-pulled changes
- a branch comparison tool (**Compare <current branch> with <branch, tag, or ref>**) — [optionally](#repositories-view-settings- 'Jump to the Repositories view settings') shows a comparison of the current branch (or working tree) to a user-selected reference
- the current branch status — shows the upstream status of the current branch (if not up to date)
- **Publish <current branch> to remote**— shown when the current branch has not been published to a remote
- **Changes to push to <remote>**— lists of all the files changed in the unpublished commits when the current branch has (unpublished) commits that waiting to be pushed to the upstream remote
- **Changes to pull from <remote>**— lists all of the commits waiting to be pulled when the current branch has commits that are waiting to be pulled from the upstream remote
- any associated pull request — shows any opened pull request associated with the current branch
- **Behind**— lists the commits that are missing from the current branch (i.e. behind) but exist in the selected reference
- **# files changed**— lists all of the files changed between the compared references
- **Ahead**— lists the commits that the current branch has (i.e. ahead) but are missing in the selected reference
- **# files changed**— lists all of the files changed between the compared references
- the changed files — lists all of the files changed by the unpublished (unpushed) commits and [optionally](#repositories-view-settings- 'Jump to the Repositories view settings') any working tree changes
- the current branch commits — similar to the [Commits view](#commits-view- 'Commits view')
- the local branches — similar to the [Branches view](#branches-view- 'Branches view')
- the contributors — similar to the [Contributors view](#contributors-view- 'Contributors view')
- any incoming activity (experimental) — lists the command, branch (if available), and date of recent incoming activity (merges and pulls) to your local repository
- the remotes and remote branches — similar to the [Remotes view](#remotes-view- 'Remotes view')
- the stashes — similar to the [Stashes view](#stashes-view- 'Stashes view')
- the tags — similar to the [Tags view](#tags-view- 'Tags view')
- **# files changed**— [optionally](#repositories-view-settings- 'Jump to the Repositories view settings') lists all of the files changed in the working tree
- the current branch status — [optionally](#repositories-view-settings- 'Jump to the Repositories view settings') shows the upstream status of the current branch
- **Publish <current branch> to remote**— shown when the current branch has not been published to a remote
- **Up to date with <remote>**— shown when the current branch is up to date with the upstream remote
- **Changes to pull from <remote>**— lists all of the unpulled commits and all of the files changed in them, when the current branch has commits that are waiting to be pulled from the upstream remote
- **Changes to push to <remote>**— lists of all the unpublished commits and all of the files changed in them, when the current branch has commits that waiting to be pushed to the upstream remote
- any associated pull request — [optionally](#repositories-view-settings- 'Jump to the Repositories view settings') shows any opened pull request associated with the current branch
- **Commits**— [optionally](#repositories-view-settings- 'Jump to the Repositories view settings') shows the current branch commits, similar to the [Commits view](#commits-view- 'Commits view')
- **Branches**— [optionally](#repositories-view-settings- 'Jump to the Repositories view settings') shows the local branches, similar to the [Branches view](#branches-view- 'Branches view')
- **Remotes**— [optionally](#repositories-view-settings- 'Jump to the Repositories view settings') shows the remotes and remote branches, similar to the [Remotes view](#remotes-view- 'Remotes view')
- **Stashes**— [optionally](#repositories-view-settings- 'Jump to the Repositories view settings') shows the stashes, similar to the [Stashes view](#stashes-view- 'Stashes view')
- **Tags**— [optionally](#repositories-view-settings- 'Jump to the Repositories view settings') shows the tags, similar to the [Tags view](#tags-view- 'Tags view')
- **Contributors**— [optionally](#repositories-view-settings- 'Jump to the Repositories view settings') shows the contributors, similar to the [Contributors view](#contributors-view- 'Contributors view')
- **Incoming Activity** (experimental) — [optionally](#repositories-view-settings- 'Jump to the Repositories view settings') shows any incoming activity, which lists the command, branch (if available), and date of recent incoming activity (merges and pulls) to your local repository
---
@ -727,19 +728,28 @@ See also [View Settings](#view-settings- 'Jump to the View settings')
See also [View Settings](#view-settings- 'Jump to the View settings')
| `gitlens.views.repositories.avatars` | Specifies whether to show avatar images instead of commit (or status) icons 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.compact` | Specifies whether to show the _Repositories_ view in a compact display density |
| `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.showBranchComparison` | Specifies whether to show a comparison of a user-selected reference (branch, tag. etc) to the current branch or the working tree in the _Repositories_ view |
| `gitlens.views.repositories.avatars` | Specifies whether to show avatar images instead of commit (or status) icons 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.branches.showBranchComparison` | Specifies whether to show a comparison of the branch with a user-selected reference (branch, tag. etc) under _Branches_ in the _Repositories_ view view |
| `gitlens.views.repositories.compact` | Specifies whether to show the _Repositories_ view in a compact display density |
| `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.showBranchComparison` | Specifies whether to show a comparison of a user-selected reference (branch, tag. etc) to the current branch or the working tree in the _Repositories_ view |
| `gitlens.views.repositories.showBranches` | Specifies whether to show the branches for each repository in the _Repositories_ view |
| `itlens.views.repositories.showCommits` | Specifies whether to show the commits on the current branch for each repository in the _Repositories_ view |
| `gitlens.views.repositories.showContributors` | Specifies whether to show the contributors for each repository in the _Repositories_ view |
| `gitlens.views.repositories.showIncomingActivity` | Specifies whether to show the experimental incoming activity for each repository in the _Repositories_ view |
| `gitlens.views.repositories.showRemotes` | Specifies whether to show the remotes for each repository in the _Repositories_ view |
| `gitlens.views.repositories.showStashes` | Specifies whether to show the stashes for each repository in the _Repositories_ view |
| `gitlens.views.repositories.showTags` | Specifies whether to show the tags for each repository in the _Repositories_ view |
| `gitlens.views.repositories.showUpstreamStatus` | Specifies whether to show the upstream status of the current branch for each repository in the _Repositories_ view |
## File History View Settings [#](#file-history-view-settings- 'File History View Settings')
"Compares the branch with a user-selected reference"
]
}
],
"default":"branch",
"markdownDescription":"Specifies whether to show a comparison of the branch with a user-selected reference (branch, tag. etc) under _Branches_ in the _Repositories_ view",
"scope":"window"
},
"gitlens.views.repositories.compact":{
"type":"boolean",
"default":false,
@ -2108,6 +2129,54 @@
"markdownDescription":"Specifies whether to show a comparison of the current branch or the working tree with a user-selected reference (branch, tag. etc) in the _Repositories_ view",
"scope":"window"
},
"gitlens.views.repositories.showBranches":{
"type":"boolean",
"default":true,
"markdownDescription":"Specifies whether to show the branches for each repository in the _Repositories_ view",
"scope":"window"
},
"gitlens.views.repositories.showCommits":{
"type":"boolean",
"default":true,
"markdownDescription":"Specifies whether to show the commits on the current branch for each repository in the _Repositories_ view",
"scope":"window"
},
"gitlens.views.repositories.showContributors":{
"type":"boolean",
"default":true,
"markdownDescription":"Specifies whether to show the contributors for each repository in the _Repositories_ view",