From 7a03507f3c64ac9716a159dcdcb1b483364be874 Mon Sep 17 00:00:00 2001
From: Mike Blumenkrantz <michael.blumenkrantz@gmail.com>
Date: Wed, 8 Sep 2021 12:42:17 -0400
Subject: [PATCH] zink: document ZINK_DESCRIPTORS env var

Reviewed-by: Dave Airlie <airlied@redhat.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/12783>
---
 docs/drivers/zink.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/drivers/zink.rst b/docs/drivers/zink.rst
index 70aa7509562..3942d7c1647 100644
--- a/docs/drivers/zink.rst
+++ b/docs/drivers/zink.rst
@@ -227,6 +227,23 @@ are required to be supported
 
   * `VK_KHR_draw_indirect_count`_
 
+Performance
+-----------
+
+If you notice poor performance and high CPU usage while running an application,
+changing the descriptor manager may improve performance:
+
+.. envvar:: ZINK_DESCRIPTORS <mode> ("auto")
+
+``auto``
+   Automatically detect best mode. This is the default.
+``lazy``
+   Disable caching and attempt to use the least amount of CPU.
+``nofallback``
+   Always use caching to try reducing GPU churn.
+``notemplates``
+   The same as `auto`, but disables the use of `VK_KHR_descriptor_templates`.
+
 Debugging
 ---------