From 1ec873376b96e708119964e4d8a8e0b69e9c8012 Mon Sep 17 00:00:00 2001
From: Zhongwang Zhang <quic_zhozhan@quicinc.com>
Date: Wed, 21 Jun 2023 17:31:01 +0800
Subject: [PATCH] doc: Document !1786

And update !2051's changelog a little bit.

Part-of: <https://gitlab.freedesktop.org/monado/monado/-/merge_requests/1786>
---
 doc/changes/auxiliary/mr.1786.md  | 2 ++
 doc/changes/compositor/mr.1786.md | 1 +
 doc/changes/xrt/mr.1786.md        | 6 ++++++
 3 files changed, 9 insertions(+)
 create mode 100644 doc/changes/auxiliary/mr.1786.md
 create mode 100644 doc/changes/compositor/mr.1786.md
 create mode 100644 doc/changes/xrt/mr.1786.md

diff --git a/doc/changes/auxiliary/mr.1786.md b/doc/changes/auxiliary/mr.1786.md
new file mode 100644
index 000000000..b5c460c76
--- /dev/null
+++ b/doc/changes/auxiliary/mr.1786.md
@@ -0,0 +1,2 @@
+a/android: Add APIs for getting supported/current display refresh rates/rate
+on Android device.
diff --git a/doc/changes/compositor/mr.1786.md b/doc/changes/compositor/mr.1786.md
new file mode 100644
index 000000000..f85b9a4dd
--- /dev/null
+++ b/doc/changes/compositor/mr.1786.md
@@ -0,0 +1 @@
+main: Implement the dynamic display refresh rates support on Android platform.
diff --git a/doc/changes/xrt/mr.1786.md b/doc/changes/xrt/mr.1786.md
new file mode 100644
index 000000000..56d8e66f9
--- /dev/null
+++ b/doc/changes/xrt/mr.1786.md
@@ -0,0 +1,6 @@
+- Add `xrt_compositor::get_display_refresh_rate` so that the application can
+  get the current display refresh rate.
+- Add `xrt_compositor::request_display_refresh_rate` so that the application can
+  trigger a display refresh rate change.
+- Add `xrt_compositor_event_display_refresh_rate_change` for compositor can
+  notify applications that the display refresh rate has been changed.