diff --git a/reference/filesystem/functions/mkdir.xml b/reference/filesystem/functions/mkdir.xml
index c6300e31d6..369bcf6fcc 100644
--- a/reference/filesystem/functions/mkdir.xml
+++ b/reference/filesystem/functions/mkdir.xml
@@ -16,7 +16,7 @@
    <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Attempts to create the directory specified by pathname. The directory must not already exist, and the relevant permissions must permit this. An E_WARNING level error will be generated on failure.
+   Attempts to create the directory specified by pathname. 
   </para>
  </refsect1>
 
@@ -156,6 +156,18 @@ if (!mkdir($structure, 0, true)) {
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Emits an <constant>E_WARNING</constant> level error if the directory
+   already exists.
+  </para>
+  <para>
+   Emits an <constant>E_WARNING</constant> level error if the relevant
+   permissions prevent creating the directory.
+  </para>
+ </refsect1>
+
  <refsect1 role="notes">
   &reftitle.notes;
   &note.sm.uidcheck.dir;