From 9bc94af73e011b94ab4222e13140c1509950463b Mon Sep 17 00:00:00 2001
From: Hannes Magnusson <bjori@php.net>
Date: Sun, 2 Sep 2007 22:11:56 +0000
Subject: [PATCH] Improve parameter description

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@242080 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/filesystem/functions/ftruncate.xml | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/reference/filesystem/functions/ftruncate.xml b/reference/filesystem/functions/ftruncate.xml
index 63e98fac33..378df2df62 100644
--- a/reference/filesystem/functions/ftruncate.xml
+++ b/reference/filesystem/functions/ftruncate.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
+<!-- $Revision: 1.12 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.14 -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ftruncate">
  <refnamediv>
@@ -28,6 +28,11 @@
       <para>
        The file pointer.
       </para>
+      <note>
+       <para>
+        The <parameter>handle</parameter> must be open for writing.
+       </para>
+      </note>
      </listitem>
     </varlistentry>
     <varlistentry>
@@ -36,6 +41,16 @@
       <para>
        The size to truncate to.
       </para>
+      <note>
+       <para>
+        If <parameter>size</parameter> is larger than the file it is extended
+        with null bytes.
+       </para>
+       <para>
+        If <parameter>size</parameter> is smaller than the file the extra data
+        will be lost.
+       </para>
+      </note>
      </listitem>
     </varlistentry>
    </variablelist>