From f0cff9db0c72d2af241e51ee500a011ceed66158 Mon Sep 17 00:00:00 2001
From: Jakob Bornecrantz <jakob@collabora.com>
Date: Fri, 7 Apr 2023 21:40:04 +0100
Subject: [PATCH] doc: Document !1763

---
 doc/changes/auxiliary/mr.1763.md    | 2 ++
 doc/changes/compositor/mr.1763.1.md | 3 +++
 doc/changes/compositor/mr.1763.2.md | 3 +++
 doc/changes/xrt/mr.1763.md          | 4 ++++
 4 files changed, 12 insertions(+)
 create mode 100644 doc/changes/auxiliary/mr.1763.md
 create mode 100644 doc/changes/compositor/mr.1763.1.md
 create mode 100644 doc/changes/compositor/mr.1763.2.md
 create mode 100644 doc/changes/xrt/mr.1763.md

diff --git a/doc/changes/auxiliary/mr.1763.md b/doc/changes/auxiliary/mr.1763.md
new file mode 100644
index 000000000..8b228c352
--- /dev/null
+++ b/doc/changes/auxiliary/mr.1763.md
@@ -0,0 +1,2 @@
+vk: Refactor `vk_csci_get_image_usage_flags` to not always set the sampled bit
+and other bits that where always set. Also tidy with a nice define for checking.
diff --git a/doc/changes/compositor/mr.1763.1.md b/doc/changes/compositor/mr.1763.1.md
new file mode 100644
index 000000000..07a7a424e
--- /dev/null
+++ b/doc/changes/compositor/mr.1763.1.md
@@ -0,0 +1,3 @@
+client: Use correct format in get_swapchain_create_properties functions, client
+compositors are given their formats, make then translate to Vulkan before
+passing on.
diff --git a/doc/changes/compositor/mr.1763.2.md b/doc/changes/compositor/mr.1763.2.md
new file mode 100644
index 000000000..028d7a183
--- /dev/null
+++ b/doc/changes/compositor/mr.1763.2.md
@@ -0,0 +1,3 @@
+client: Respect native compositor's extra usage bits, so we can remove the
+hardcoded always sampled bit. This also ensures that images have exactly the
+same usages in both the compositor and app.
diff --git a/doc/changes/xrt/mr.1763.md b/doc/changes/xrt/mr.1763.md
new file mode 100644
index 000000000..3feb00422
--- /dev/null
+++ b/doc/changes/xrt/mr.1763.md
@@ -0,0 +1,4 @@
+Extend `xrt_swapchain_create_properties` to allow the main compositor request
+extra bits to be used beyond those requested by the OpenXR app. Some compositors
+might need extra usage bits set beyond just the constant sampled bit. This also
+ensures that images have exactly the same usages in both the compositor and app.