From 60be5909a29650a5e7595bbdc4012b0ad0c390af Mon Sep 17 00:00:00 2001
From: Mariusz Felisiak <felisiak.mariusz@gmail.com>
Date: Thu, 16 Feb 2023 19:18:55 +0100
Subject: [PATCH] [4.1.x] Refs #21080, Refs #34322 -- Added warning to
 ManifestStaticFilesStorage docs about paths in comments.

Backport of bae053d497ba8a8de7e4f725973924bfb1885fd2 from main.
---
 docs/ref/contrib/staticfiles.txt | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/ref/contrib/staticfiles.txt b/docs/ref/contrib/staticfiles.txt
index a0b466ad28..5961670f13 100644
--- a/docs/ref/contrib/staticfiles.txt
+++ b/docs/ref/contrib/staticfiles.txt
@@ -325,6 +325,12 @@ argument. For example::
             manifest_storage = StaticFilesStorage(location=settings.BASE_DIR)
             super().__init__(*args, manifest_storage=manifest_storage, **kwargs)
 
+.. admonition:: References in comments
+
+    ``ManifestStaticFilesStorage`` doesn't ignore paths in statements that are
+    commented out. This :ticket:`may crash on the nonexistent paths <21080>`.
+    You should check and eventually strip comments.
+
 .. versionchanged:: 4.0
 
     Support for finding paths in JavaScript source map comments was added.