summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNatalia <124304+nessita@users.noreply.github.com>2026-06-16 12:02:46 -0300
committernessita <124304+nessita@users.noreply.github.com>2026-06-16 12:58:57 -0300
commitb3af3404b183597b8554219a6f03cb67cc61b876 (patch)
treed0a2a7fdf6a8faa14729ce4ea40ce1726b26e289
parentf89101088a149d8c9eca4e4796723a3f0de5b129 (diff)
Refs #37142 -- Removed docs for django.utils.warnings.django_file_prefixes().
This reverts docs changes from commit f970a98e464320c09dde8d45009eadfb4d038a57.
-rw-r--r--docs/ref/utils.txt28
-rw-r--r--docs/releases/6.2.txt5
2 files changed, 1 insertions, 32 deletions
diff --git a/docs/ref/utils.txt b/docs/ref/utils.txt
index 0f38105713..1c42784d13 100644
--- a/docs/ref/utils.txt
+++ b/docs/ref/utils.txt
@@ -1187,31 +1187,3 @@ For a complete discussion on the usage of the following see the
Turns a Django template into something that is understood by ``xgettext``.
It does so by translating the Django translation tags into standard
``gettext`` function invocations.
-
-``django.utils.warnings``
-=========================
-
-.. module:: django.utils.warnings
- :synopsis: Helpers for issuing warnings.
-
-.. function:: django_file_prefixes()
-
- .. versionadded:: 6.2
-
- Returns a tuple of file path prefixes for the Django package directory.
- This is used as the ``skip_file_prefixes`` argument to
- :func:`warnings.warn` so that warnings are attributed to the *caller*
- (your project or third-party library) rather than to Django internals.
-
- The result is cached after the first call.
-
- Usage example::
-
- import warnings
- from django.utils.warnings import django_file_prefixes
-
- warnings.warn(
- "Your custom warning message.",
- category=RuntimeWarning,
- skip_file_prefixes=django_file_prefixes(),
- )
diff --git a/docs/releases/6.2.txt b/docs/releases/6.2.txt
index b949b0aa24..f1bde4805c 100644
--- a/docs/releases/6.2.txt
+++ b/docs/releases/6.2.txt
@@ -234,10 +234,7 @@ URLs
Utilities
~~~~~~~~~
-* The new ``django.utils.warnings`` module provides
- :func:`~django.utils.warnings.django_file_prefixes`, which returns the file
- path prefix of the Django package for use as the ``skip_file_prefixes``
- argument of :func:`warnings.warn`.
+* ...
Validators
~~~~~~~~~~