diff --git a/docs/src/reference/all-settings.md b/docs/src/reference/all-settings.md index e584dd6414..a425a0605e 100644 --- a/docs/src/reference/all-settings.md +++ b/docs/src/reference/all-settings.md @@ -134,13 +134,35 @@ Non-negative `float` values ## Auto Indent -- Description: Whether indentation should be adjusted based on context while typing. This can be specified on a per-language basis. +- Description: Controls automatic indentation behavior when typing. This can be specified on a per-language basis. - Setting: `auto_indent` -- Default: `true` +- Default: `syntax_aware` **Options** -`boolean` values +1. `syntax_aware`, adjusts indentation based on syntax context, using Tree-sitter to analyze the code structure: + +```json [settings] +{ + "auto_indent": "syntax_aware" +} +``` + +2. `preserve_indent`, keeps the indentation of the current line when starting a new one, without adjusting for syntax: + +```json [settings] +{ + "auto_indent": "preserve_indent" +} +``` + +3. `none`, disables automatic indentation, so new lines start at column 0: + +```json [settings] +{ + "auto_indent": "none" +} +``` ## Auto Indent On Paste @@ -544,7 +566,7 @@ When enabled, this setting will automatically close tabs for files that have bee - Description: Which level to use to filter out diagnostics displayed in the editor - Setting: `diagnostics_max_severity` -- Default: `null` +- Default: `all` **Options** @@ -689,7 +711,7 @@ For the case of "open", regular selection behavior can be achieved by holding `a - 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", "**/.dev.vars", "**/secrets.yml"]` +- Default: `["**/.env*", "**/*.pem", "**/*.key", "**/*.cert", "**/*.crt", "**/.dev.vars", "**/secrets.yml", "**/.zed/settings.json", "/**/zed/settings.json", "/**/zed/keymap.json"]` **Options** @@ -2065,7 +2087,9 @@ Non-negative `integer` values - Description: Whether or not to perform a buffer format before saving. - Setting: `format_on_save` -- Default: `on` +- Default: `off` + +Zed ships `"format_on_save": "on"` as a per-language default for Astro, Dart, EEx, Elixir, Elm, Go, GraphQL, HEEx, Kotlin, Rust, Starlark, and Zig. Every other language uses the top-level default above. Use [`languages`](#languages) to configure individual languages differently. **Options** @@ -2526,7 +2550,7 @@ To interpret all `.c` files as C++, files called `MyLockFile` as TOML and files - Description: Sets the debounce threshold (in milliseconds) after which changes are reflected in the git gutter. - Setting: `gutter_debounce` -- Default: `null` +- Default: `0` **Options** @@ -4536,7 +4560,7 @@ 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: `off` +- Default: `on` **Options** @@ -4620,9 +4644,9 @@ List of `integer` column numbers ### Terminal: Cursor Shape -- Description: Controls the visual shape of the cursor in the terminal. When not explicitly set, it defaults to a block shape. +- Description: Controls the visual shape of the cursor in the terminal. - Setting: `cursor_shape` -- Default: `null` (defaults to block) +- Default: `block` **Options**