From a8b8a6fd6d66d481a54caf2958fa5a35de960f95 Mon Sep 17 00:00:00 2001
From: Volker Hilsheimer <volker.hilsheimer@qt.io>
Date: Tue, 17 Dec 2024 11:35:36 +0100
Subject: [PATCH] QPainterStateGuard: document that restore() asserts when
 already at 0

Address comment from header review, amends
9ecf47a8a8d11227ecf192246d7df7c2c4dc9105.

Task-number: QTBUG-132090
Change-Id: Ie6eed6f83fcdde0f90514b6016a65905505073e0
Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>
(cherry picked from commit 8ae4e3efdf80b658f8de19b13bfbea68e1dbd875)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
---
 src/gui/painting/qpainterstateguard.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/gui/painting/qpainterstateguard.cpp b/src/gui/painting/qpainterstateguard.cpp
index 476b6ad8af9..96aa182dab8 100644
--- a/src/gui/painting/qpainterstateguard.cpp
+++ b/src/gui/painting/qpainterstateguard.cpp
@@ -50,6 +50,8 @@ QT_BEGIN_NAMESPACE
 /*!
     \fn void QPainterStateGuard::restore()
     Calls QPainter::restore() if the internal save/restore counter is greater than zero.
+
+    \note This function asserts in debug builds if the counter has already reached zero.
 */
 
 QT_END_NAMESPACE