diff --git a/reference/filesystem/functions/pathinfo.xml b/reference/filesystem/functions/pathinfo.xml
index 151fd76910..da328a319f 100644
--- a/reference/filesystem/functions/pathinfo.xml
+++ b/reference/filesystem/functions/pathinfo.xml
@@ -25,6 +25,13 @@
     predefined reserved variables</link>.
    </para>
   </note>
+  <note>
+   <para>
+    <function>pathinfo</function> operates naively on the input string,
+    and is not aware of the actual filesystem, or path components such
+    as "<literal>..</literal>".
+   </para>
+  </note>
   <caution>
    <para>
     <function>pathinfo</function> is locale aware, so for it to parse a path