diff --git a/reference/filesystem/functions/file.xml b/reference/filesystem/functions/file.xml
index c179aeefb7..57d96133e2 100644
--- a/reference/filesystem/functions/file.xml
+++ b/reference/filesystem/functions/file.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.file">
    <refnamediv>
@@ -17,7 +17,8 @@
      Identical to <function>readfile</function>, except that
      <function>file</function> returns the file in an array. Each
      element of the array corresponds to a line in the file, with the
-     newline still attached.
+     newline still attached.  Upon failure, <function>file</function>
+     returns &false;.
     </para>
     <note>
      <para>
@@ -28,8 +29,8 @@
     </note>
     &note.line-endings;
     <para>
-     You can use the optional second parameter and set it to "1", if
-     you want to search for the file in the <link
+     You can use the optional <parameter>use_include_path</parameter> parameter 
+     and set it to "1", if you want to search for the file in the <link
      linkend="ini.include-path">include_path</link>, too.
     </para>
     <para>