From 5fec130f9392c002a10cc383723c5e0c80120106 Mon Sep 17 00:00:00 2001
From: Stephen Early <steve@assorted.org.uk>
Date: Sun, 7 Jul 2024 10:24:07 +0100
Subject: [PATCH] Documentation update regarding branches

---
 README.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.rst b/README.rst
index 5749b44..880a027 100644
--- a/README.rst
+++ b/README.rst
@@ -30,5 +30,16 @@ at least release major.minor.0 of libxkbcommon to build and run, and
 should work with any subsequent release. The patch version of the
 Python package is unrelated to the patch version of libxkbcommon.
 
+In practice this means that **you should always specify a maximum
+version when depending on xkbcommon**.
+
+* Most users should specify ``xkbcommon<1.1``
+
+* If you need to use ``xkb.Context(no_secure_getenv=True)`` then
+  specify ``xkbcommon<1.6``
+
+* If you need to iterate over an ``xkb.ComposeTable`` instance then
+  specify ``xkbcommon<1.7``
+
 .. _libxkbcommon: https://xkbcommon.org/
 .. _cffi: https://pypi.python.org/pypi/cffi