From 2aae3ab448d83ac920406e5aaec103818827b941 Mon Sep 17 00:00:00 2001
From: Junkui Zhang <364772080@qq.com>
Date: Thu, 5 Sep 2024 23:03:09 +0800
Subject: [PATCH] docs: Update `buffer_font_fallbacks` and clarify that
 `*_font_features` is macOS and Windows only (#17355)

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
---
 docs/src/configuring-zed.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/docs/src/configuring-zed.md b/docs/src/configuring-zed.md
index 6f0283f848d40619e15ecc71329a02fe3679beef..799e00f083d7e42b300b340d8e01ba42f65419e9 100644
--- a/docs/src/configuring-zed.md
+++ b/docs/src/configuring-zed.md
@@ -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**