diff --git a/reference/filesystem/functions/dirname.xml b/reference/filesystem/functions/dirname.xml
index 05fd795222..0d5cfd261b 100644
--- a/reference/filesystem/functions/dirname.xml
+++ b/reference/filesystem/functions/dirname.xml
@@ -82,6 +82,25 @@
path with any trailing
/component removed.
+
+
+
+ Be careful when using this function in a loop that can reach the
+ top-level directory as this can result in an infinite loop.
+
+
+
+]]>
+
+
+
+