From 2f7793196a8feac9d5ce96ae0a8df0723ef1b044 Mon Sep 17 00:00:00 2001
From: "Miss Islington (bot)"
 <31488909+miss-islington@users.noreply.github.com>
Date: Sat, 2 Nov 2024 12:43:30 +0100
Subject: [PATCH] [3.13] gh-125761: Clarify repeated warning suppression
 criteria in warnings module (gh-126330)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

(cherry picked from commit 10eeec2d4ffb6b09a6d925877b6d9ef6aa6bb59d)

Co-authored-by: 고병찬 <70642609+byungchanKo99@users.noreply.github.com>
---
 Doc/library/warnings.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst
index e4942fa0c184..40b96080a3c9 100644
--- a/Doc/library/warnings.rst
+++ b/Doc/library/warnings.rst
@@ -178,6 +178,19 @@ If a warning is reported and doesn't match any registered filter then the
 "default" action is applied (hence its name).
 
 
+
+.. _repeated-warning-suppression-criteria:
+
+Repeated Warning Suppression Criteria
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The filters that suppress repeated warnings apply the following criteria to determine if a warning is considered a repeat:
+
+- ``"default"``: A warning is considered a repeat only if the (*message*, *category*, *module*, *lineno*) are all the same.
+- ``"module"``: A warning is considered a repeat if the (*message*, *category*, *module*) are the same, ignoring the line number.
+- ``"once"``: A warning is considered a repeat if the (*message*, *category*) are the same, ignoring the module and line number.
+
+
 .. _describing-warning-filters:
 
 Describing Warning Filters
-- 
2.47.3