diff --git a/reference/filesystem/functions/mkdir.xml b/reference/filesystem/functions/mkdir.xml
index a6d3e88b9c..72d47b3940 100644
--- a/reference/filesystem/functions/mkdir.xml
+++ b/reference/filesystem/functions/mkdir.xml
@@ -36,8 +36,8 @@
      <term><parameter>permissions</parameter></term>
      <listitem>
       <para>
-       The <parameter>permissions</parameter> are 0777 by default, which means the widest possible
-       access. For more information on modes, read the details
+       The permissions are 0777 by default, which means the widest possible
+       access. For more information on permissions, read the details
        on the <function>chmod</function> page.
       </para>
       <note>
@@ -46,8 +46,8 @@
        </para>
       </note>
       <para>
-       Note that you probably want to specify the mode as an octal number,
-       which means it should have a leading zero. The mode is also modified
+       Note that you probably want to specify the <parameter>permissions</parameter> as an octal number,
+       which means it should have a leading zero. The <parameter>permissions</parameter> is also modified
        by the current umask, which you can change using
        <function>umask</function>.
       </para>