Update docs for some settings (#27474)
Fix incorrect defaults or descriptions and add missing content. Release Notes: - N/A --------- Co-authored-by: Peter Tripp <peter@zed.dev>
This commit is contained in:
parent
feb1d37798
commit
7257053df4
1 changed files with 95 additions and 39 deletions
|
@ -383,13 +383,10 @@ left and right padding of the central pane from the workspace when the centered
|
|||
`direnv` integration make it possible to use the environment variables set by a `direnv` configuration to detect some language servers in `$PATH` instead of installing them.
|
||||
It also allows for those environment variables to be used in tasks.
|
||||
- Setting: `load_direnv`
|
||||
- Default:
|
||||
|
||||
```json
|
||||
"load_direnv": "direct"
|
||||
```
|
||||
- Default: `"direct"`
|
||||
|
||||
**Options**
|
||||
|
||||
There are two options to choose from:
|
||||
|
||||
1. `shell_hook`: Use the shell hook to load direnv. This relies on direnv to activate upon entering the directory. Supports POSIX shells and fish.
|
||||
|
@ -409,6 +406,7 @@ There are two options to choose from:
|
|||
"**/*.key",
|
||||
"**/*.cert",
|
||||
"**/*.crt",
|
||||
"**/.dev.vars",
|
||||
"**/secrets.yml"
|
||||
]
|
||||
}
|
||||
|
@ -420,7 +418,7 @@ There are two options to choose from:
|
|||
|
||||
- Description: A list of globs for which edit predictions should be disabled for. This list adds to a pre-existing, sensible default set of globs. Any additional ones you add are combined with them.
|
||||
- Setting: `disabled_globs`
|
||||
- Default: `["**/.env*", "**/*.pem", "**/*.key", "**/*.cert", "**/*.crt", "**/secrets.yml"]`
|
||||
- Default: `["**/.env*", "**/*.pem", "**/*.key", "**/*.cert", "**/*.crt", "**/.dev.vars", "**/secrets.yml"]`
|
||||
|
||||
**Options**
|
||||
|
||||
|
@ -814,7 +812,8 @@ List of `string` values
|
|||
"file_icons": false,
|
||||
"git_status": false,
|
||||
"activate_on_close": "history",
|
||||
"show_close_button": "hover"
|
||||
"show_close_button": "hover",
|
||||
"show_diagnostics": "off"
|
||||
},
|
||||
```
|
||||
|
||||
|
@ -918,6 +917,38 @@ List of `string` values
|
|||
}
|
||||
```
|
||||
|
||||
### Show Diagnostics
|
||||
|
||||
- Description: Whether to show diagnostics indicators in tabs. This setting only works when file icons are active and controls which files with diagnostic issues to mark.
|
||||
- Setting: `show_diagnostics`
|
||||
- Default: `off`
|
||||
|
||||
**Options**
|
||||
|
||||
1. Do not mark any files:
|
||||
|
||||
```json
|
||||
{
|
||||
"show_diagnostics": "off"
|
||||
}
|
||||
```
|
||||
|
||||
2. Only mark files with errors:
|
||||
|
||||
```json
|
||||
{
|
||||
"show_diagnostics": "errors"
|
||||
}
|
||||
```
|
||||
|
||||
3. Mark files with errors and warnings:
|
||||
|
||||
```json
|
||||
{
|
||||
"show_diagnostics": "all"
|
||||
}
|
||||
```
|
||||
|
||||
## Editor Toolbar
|
||||
|
||||
- Description: Whether or not to show various elements in the editor toolbar.
|
||||
|
@ -927,7 +958,8 @@ List of `string` values
|
|||
```json
|
||||
"toolbar": {
|
||||
"breadcrumbs": true,
|
||||
"quick_actions": true
|
||||
"quick_actions": true,
|
||||
"selections_menu": true
|
||||
},
|
||||
```
|
||||
|
||||
|
@ -1244,7 +1276,14 @@ Note, specifying `file_scan_exclusions` in settings.json will override the defau
|
|||
|
||||
- Setting: `file_types`
|
||||
- Description: Configure how Zed selects a language for a file based on its filename or extension. Supports glob entries.
|
||||
- Default: `{}`
|
||||
- Default:
|
||||
|
||||
```json
|
||||
"file_types": {
|
||||
"JSONC": ["**/.zed/**/*.json", "**/zed/**/*.json", "**/Zed/**/*.json", "**/.vscode/**/*.json"],
|
||||
"Shell Script": [".env.*"]
|
||||
}
|
||||
```
|
||||
|
||||
**Examples**
|
||||
|
||||
|
@ -1990,12 +2029,6 @@ Or to set a `socks5` proxy:
|
|||
|
||||
- Description: When enabled, automatically adjusts search case sensitivity based on your query. If your search query contains any uppercase letters, the search becomes case-sensitive; if it contains only lowercase letters, the search becomes case-insensitive. \
|
||||
This applies to both in-file searches and project-wide searches.
|
||||
|
||||
Examples:
|
||||
|
||||
- Searching for "function" would match "function", "Function", "FUNCTION", etc.
|
||||
- Searching for "Function" would only match "Function", not "function" or "FUNCTION"
|
||||
|
||||
- Setting: `use_smartcase_search`
|
||||
- Default: `false`
|
||||
|
||||
|
@ -2003,6 +2036,11 @@ Or to set a `socks5` proxy:
|
|||
|
||||
`boolean` values
|
||||
|
||||
Examples:
|
||||
|
||||
- Searching for "function" would match "function", "Function", "FUNCTION", etc.
|
||||
- Searching for "Function" would only match "Function", not "function" or "FUNCTION"
|
||||
|
||||
## Show Call Status Icon
|
||||
|
||||
- Description: Whether or not to show the call status icon in the status bar.
|
||||
|
@ -2134,10 +2172,12 @@ List of `integer` column numbers
|
|||
```json
|
||||
{
|
||||
"terminal": {
|
||||
"alternate_scroll": "on",
|
||||
"alternate_scroll": "off",
|
||||
"blinking": "terminal_controlled",
|
||||
"copy_on_select": false,
|
||||
"dock": "bottom",
|
||||
"default_width": 640,
|
||||
"default_height": 320,
|
||||
"detect_venv": {
|
||||
"on": {
|
||||
"directories": [".env", "env", ".venv", "venv"],
|
||||
|
@ -2150,8 +2190,8 @@ List of `integer` column numbers
|
|||
"font_size": null,
|
||||
"line_height": "comfortable",
|
||||
"option_as_meta": false,
|
||||
"button": false,
|
||||
"shell": {},
|
||||
"button": true,
|
||||
"shell": "system",
|
||||
"toolbar": {
|
||||
"breadcrumbs": true
|
||||
},
|
||||
|
@ -2177,21 +2217,11 @@ List of `integer` column numbers
|
|||
|
||||
- Description: Set whether Alternate Scroll mode (DECSET code: `?1007`) is active by default. Alternate Scroll mode converts mouse scroll events into up / down key presses when in the alternate screen (e.g. when running applications like vim or less). The terminal can still set and unset this mode with ANSI escape codes.
|
||||
- Setting: `alternate_scroll`
|
||||
- Default: `on`
|
||||
- Default: `off`
|
||||
|
||||
**Options**
|
||||
|
||||
1. Default alternate scroll mode to on
|
||||
|
||||
```json
|
||||
{
|
||||
"terminal": {
|
||||
"alternate_scroll": "on"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
2. Default alternate scroll mode to off
|
||||
1. Default alternate scroll mode to off
|
||||
|
||||
```json
|
||||
{
|
||||
|
@ -2201,6 +2231,16 @@ List of `integer` column numbers
|
|||
}
|
||||
```
|
||||
|
||||
2. Default alternate scroll mode to on
|
||||
|
||||
```json
|
||||
{
|
||||
"terminal": {
|
||||
"alternate_scroll": "on"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Terminal: Blinking
|
||||
|
||||
- Description: Set the cursor blinking behavior in the terminal
|
||||
|
@ -2453,7 +2493,7 @@ See Buffer Font Features
|
|||
// Default directories to search for virtual environments, relative
|
||||
// to the current working directory. We recommend overriding this
|
||||
// in your project's settings, rather than globally.
|
||||
"directories": [".venv", "venv"],
|
||||
"directories": [".env", "env", ".venv", "venv"],
|
||||
// Can also be `csh`, `fish`, and `nushell`
|
||||
"activate_script": "default"
|
||||
}
|
||||
|
@ -2668,6 +2708,7 @@ Run the `theme selector: toggle` action in the command palette to see a current
|
|||
"scrollbar": {
|
||||
"show": null
|
||||
},
|
||||
"show_diagnostics": "all",
|
||||
"indent_guides": {
|
||||
"show": "always"
|
||||
}
|
||||
|
@ -2751,11 +2792,11 @@ Run the `theme selector: toggle` action in the command palette to see a current
|
|||
|
||||
- Description: Customize default width taken by project panel
|
||||
- Setting: `default_width`
|
||||
- Default: N/A width in pixels (eg: 420)
|
||||
- Default: `240`
|
||||
|
||||
**Options**
|
||||
|
||||
`boolean` values
|
||||
`float` values
|
||||
|
||||
### Auto Reveal Entries
|
||||
|
||||
|
@ -2813,8 +2854,9 @@ Run the `theme selector: toggle` action in the command palette to see a current
|
|||
|
||||
### Indent Guides: Show
|
||||
|
||||
- Description: Whether to show indent guides in the project panel. Possible values: "always", "never".
|
||||
- Description: Whether to show indent guides in the project panel.
|
||||
- Setting: `indent_guides`
|
||||
- Default:
|
||||
|
||||
```json
|
||||
"indent_guides": {
|
||||
|
@ -2886,14 +2928,21 @@ Run the `theme selector: toggle` action in the command palette to see a current
|
|||
|
||||
```json
|
||||
"assistant": {
|
||||
"version": "2",
|
||||
"enabled": true,
|
||||
"button": true,
|
||||
"dock": "right",
|
||||
"default_width": 640,
|
||||
"default_height": 320,
|
||||
"provider": "openai",
|
||||
"version": "1",
|
||||
},
|
||||
"default_model": {
|
||||
"provider": "zed.dev",
|
||||
"model": "claude-3-5-sonnet-latest"
|
||||
},
|
||||
"editor_model": {
|
||||
"provider": "zed.dev",
|
||||
"model": "claude-3-5-sonnet-latest"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Outline Panel
|
||||
|
@ -2905,7 +2954,7 @@ Run the `theme selector: toggle` action in the command palette to see a current
|
|||
```json
|
||||
"outline_panel": {
|
||||
"button": true,
|
||||
"default_width": 240,
|
||||
"default_width": 300,
|
||||
"dock": "left",
|
||||
"file_icons": true,
|
||||
"folder_icons": true,
|
||||
|
@ -2972,7 +3021,14 @@ The name of any font family installed on the system.
|
|||
|
||||
- Description: The OpenType features to enable for text in the UI.
|
||||
- Setting: `ui_font_features`
|
||||
- Default: `null`
|
||||
- Default:
|
||||
|
||||
```json
|
||||
"ui_font_features": {
|
||||
"calt": false
|
||||
}
|
||||
```
|
||||
|
||||
- Platform: macOS and Windows.
|
||||
|
||||
**Options**
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue