From 15032151c8e4ec066fee30501f6937753d5b640d Mon Sep 17 00:00:00 2001
From: DreamMaoMao <2523610504@qq.com>
Date: Thu, 25 Jun 2026 13:33:00 +0800
Subject: [PATCH] update docs

---
 docs/configuration/miscellaneous.md |  2 --
 docs/configuration/monitors.md      | 28 ++++++++++++++++++----------
 docs/faq.md                         |  3 ++-
 3 files changed, 20 insertions(+), 13 deletions(-)

diff --git a/docs/configuration/miscellaneous.md b/docs/configuration/miscellaneous.md
index d8871885..32dc5b42 100644
--- a/docs/configuration/miscellaneous.md
+++ b/docs/configuration/miscellaneous.md
@@ -11,8 +11,6 @@ description: Advanced settings for XWayland, focus behavior, and system integrat
 | `syncobj_enable` | `1` | Enable `drm_syncobj` timeline support (helps with gaming stutter/lag). **Requires restart.** |
 | `allow_lock_transparent` | `0` | Allow the lock screen to be transparent. |
 | `allow_shortcuts_inhibit` | `1` | Allow shortcuts to be inhibited by clients. |
-| `vrr` | - | Set via [monitor rule](/docs/configuration/monitors#monitor-rules). |
-| `hdr_hdr_depth` | `0`/`1`/`2` | Set the hdr depth for the current display. `0` is Default, `1` is HDR8, `2` is HDR10. |
 
 ## Focus & Input
 
diff --git a/docs/configuration/monitors.md b/docs/configuration/monitors.md
index ff64bc10..ff6cb8fa 100644
--- a/docs/configuration/monitors.md
+++ b/docs/configuration/monitors.md
@@ -103,6 +103,21 @@ Tearing allows games to bypass the compositor's VSync for lower latency.
 | :--- | :--- | :--- |
 | `allow_tearing` | `0` | Global tearing control: `0` (Disable), `1` (Enable), `2` (Fullscreen only). |
 
+## HDR
+| Setting | Default | Description |
+| :--- | :--- | :--- |
+| `hdr_hdr_depth` | `0`/`1`/`2` | Set the hdr depth for the current display. `0` is Default, `1` is HDR8, `2` is HDR10. |
+
+- you should enable HDR in monitorrule first, refer to [Monitors — Monitor Rules](/docs/configuration/monitors#monitor-rules)
+- you must set `env=WLR_RENDERER,vulkan` before mango starts.
+
+#### for example(must relogin once after setting):
+```conf
+env=WLR_RENDERER,vulkan
+monitorrule=name:eDP-1,model:0x15F5,width:1920,height:1080,refresh:60,x:0,y:0,scale:1,vrr:0,rr:0:hdr:1
+```
+
+
 ### Configuration
 
 **Enable Globally:**
@@ -131,16 +146,9 @@ windowrule=force_tearing:1,title:vkcube
 
 > **Warning:** Some graphics cards require setting the `WLR_DRM_NO_ATOMIC` environment variable before mango starts to successfully enable tearing.
 
-Add this to `/etc/environment` and reboot:
-
-```bash
-WLR_DRM_NO_ATOMIC=1
+Add this to config and relogin mango:
 ```
-
-Or run mango with the environment variable:
-
-```bash
-WLR_DRM_NO_ATOMIC=1 mango
+env=WLR_DRM_NO_ATOMIC,1
 ```
 
 ---
@@ -157,7 +165,7 @@ WLR_DRM_DEVICES=/dev/dri/card1 mango
 WLR_DRM_DEVICES=/dev/dri/card0:/dev/dri/card1 mango
 ```
 
-Some GPUs have compatibility issues with `syncobj_enable=1` — it may crash apps like `kitty` that use syncobj. Set `WLR_DRM_NO_ATOMIC=1` in `/etc/environment` and reboot to resolve this.
+Some GPUs have compatibility issues with `syncobj_enable=1` — it may crash apps like `kitty` that use syncobj. Set `env=WLR_DRM_NO_ATOMIC,1` in `config.conf` and relogin to resolve this.
 
 ---
 
diff --git a/docs/faq.md b/docs/faq.md
index 9c9288de..85c9f09e 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -65,7 +65,8 @@ Then force it for your specific game:
 windowrule=force_tearing:1,title:Counter-Strike 2
 ```
 
-> **Warning:** Some graphics cards require setting `WLR_DRM_NO_ATOMIC=1` before mango starts for tearing to work. Add it to `/etc/environment` and reboot, or launch mango with `WLR_DRM_NO_ATOMIC=1 mango`. See [Monitors — Tearing](/docs/configuration/monitors#tearing-game-mode) for details.
+> **Warning:** Some graphics cards require setting `env=WLR_DRM_NO_ATOMIC,1` in config before mango starts for tearing to work. 
+> See [Monitors — Tearing](/docs/configuration/monitors#tearing-game-mode) for details.
 
 ---