Warn that `right_hand_split()` modifies `bracket_depth` in leaves

diff --git a/black.py b/black.py
index 81241f6ec0248df6aee8703c0c1dc7d6330e7303..9cb6e1d0f1c897d33a6793b3fe162c49b3820719 100644 (file)
--- a/black.py
+++ b/black.py
@@ -2013,6 +2013,8 @@ def right_hand_split(
     If the split was by optional parentheses, attempt splitting without them, too.
     `omit` is a collection of closing bracket IDs that shouldn't be considered for
     this split.
+
+    Note: running this function modifies `bracket_depth` on the leaves of `line`.
     """
     head = Line(depth=line.depth)
     body = Line(depth=line.depth + 1, inside_brackets=True)