docs: Update `buffer_font_fallbacks` and clarify that `*_font_features` is macOS and Windows only (#17355)
Junkui Zhang
created
This PR introduces the following improvements:
- Added an example of `buffer_font_fallbacks` to the documentation.
- Included a note indicating that the `*_font_features` setting is
currently implemented only on macOS and Windows.
Release Notes:
- N/A
@@ -108,6 +108,7 @@ The name of any font family installed on the user's system
- Description: The OpenType features to enable for text in the editor.
- Setting: `buffer_font_features`
- Default: `null`
+- Platform: macOS and Windows.
**Options**
@@ -133,6 +134,23 @@ You can also set other OpenType features, like setting `cv01` to `7`:
}
```
+## Buffer Font Fallbacks
+
+- Description: Set the buffer text's font fallbacks, this will be merged with the platform's default fallbacks.
+- Setting: `buffer_font_fallbacks`
+- Default: `null`
+- Platform: macOS and Windows.
+
+**Options**
+
+For example, to use `Nerd Font` as a fallback, add the following to your settings:
+
+```json
+{
+ "buffer_font_fallbacks": ["Nerd Font"]
+}
+```
+
## Buffer Font Size
- Description: The default font size for text in the editor.
@@ -1432,6 +1450,7 @@ The name of any font family installed on the user's system
- Description: What font features to use for the terminal. When not set, defaults to matching the editor's font features.
- Setting: `font_features`
- Default: `null`
+- Platform: macOS and Windows.
**Options**