From e100d3f5dd995f30fd260a009dba7dfd2f3a743d Mon Sep 17 00:00:00 2001
From: Kovid Goyal <kovid@kovidgoyal.net>
Date: Sun, 13 Apr 2025 10:37:20 +0530
Subject: [PATCH] Add a warning about algorithm changes

---
 docs/text-sizing-protocol.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/text-sizing-protocol.rst b/docs/text-sizing-protocol.rst
index 8af48dbec..4cb94866f 100644
--- a/docs/text-sizing-protocol.rst
+++ b/docs/text-sizing-protocol.rst
@@ -356,6 +356,13 @@ The algorithm for splitting text into cells
    This uses tests published by the Unicode consortium, `GraphemeBreakTest.txt
    <https://www.unicode.org/Public/UCD/latest/ucd/auxiliary/GraphemeBreakTest.txt>`__.
 
+.. warning::
+   This algorithm is under public discussion in :iss:`8533`. Until that issue
+   is closed, it is subject to change based on feedback from the community.
+   Additionally, in the future if the Unicode standard changes in ways that
+   affect this algorithm, it will be updated. Currently the algorithm is based
+   on Unicode version 16.
+
 Here, we specify how a terminal must split up text into cells, where a cell is
 a width one unit in the character grid the terminal displays.