diff --git a/reference/mailparse/functions/mailparse-msg-parse-file.xml b/reference/mailparse/functions/mailparse-msg-parse-file.xml
index e65eeec9f3..dbbae8a8b3 100644
--- a/reference/mailparse/functions/mailparse-msg-parse-file.xml
+++ b/reference/mailparse/functions/mailparse-msg-parse-file.xml
@@ -28,6 +28,12 @@
        Path to the file holding the message.
        The file is opened and streamed through the parser.
       </para>
+      <note>
+       <para>
+        The message contained in <parameter>filename</parameter> is supposed to end with a newline
+        (<literal>CRLF</literal>); otherwise the last line of the message will not be parsed.
+       </para>
+      </note>
      </listitem>
     </varlistentry>
    </variablelist>
diff --git a/reference/mailparse/functions/mailparse-msg-parse.xml b/reference/mailparse/functions/mailparse-msg-parse.xml
index 14917e8b3d..ad9945aa96 100644
--- a/reference/mailparse/functions/mailparse-msg-parse.xml
+++ b/reference/mailparse/functions/mailparse-msg-parse.xml
@@ -36,8 +36,12 @@
     <varlistentry>
      <term><parameter>data</parameter></term>
      <listitem>
-      <para>
-      </para>
+      <note>
+       <para>
+        The final chunk of <parameter>data</parameter> is supposed to end with a newline
+        (<literal>CRLF</literal>); otherwise the last line of the message will not be parsed.
+       </para>
+      </note>
      </listitem>
     </varlistentry>
    </variablelist>