on master help sign in
rewrite auto-pairs docs (#2384)
f59b3b9Michael Davis
book/src/configuration.md+10−8
@@ -90,16 +90,18 @@ available, which is not defined by default.
90
90
91### `[editor.auto-pairs]` Section
91### `[editor.auto-pairs]` Section
92
92
93−Enable automatic insertion of pairs to parentheses, brackets, etc. Can be
93+Enables automatic insertion of pairs to parentheses, brackets, etc. Can be a
94−a simple boolean value, or a specific mapping of pairs of single characters.
94+simple boolean value, or a specific mapping of pairs of single characters.
95
95
96−| Key | Description |
96+To disable auto-pairs altogether, set `auto-pairs` to `false`:
97−| --- | ----------- |
98−| `false` | Completely disable auto pairing, regardless of language-specific settings
99−| `true` | Use the default pairs: <code>(){}[]''""``</code>
100−| Mapping of pairs | e.g. `{ "(" = ")", "{" = "}", ... }`
101
97
102−Example
98+```toml
99+[editor]
100+auto-pairs = false # defaults to `true`
101+```
102+
103+The default pairs are <code>(){}[]''""``</code>, but these can be customized by
104+setting `auto-pairs` to a TOML table:
103
105
104```toml
106```toml
105[editor.auto-pairs]
107[editor.auto-pairs]