From 0a82a13c66563071546e946ce3ee31fcc6ee0484 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gustavo=20Andr=C3=A9=20dos=20Santos=20Lopes?=
 <cataphract@php.net>
Date: Sat, 21 Nov 2009 02:15:16 +0000
Subject: [PATCH] Made clear that calling rar_close invalidates RarEntry
 objects but not streams obtained through RarEntry::getstream.xml().

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@291105 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/rar/functions/rar-close.xml | 26 ++++++++++++++++++++++++++
 reference/rar/rarentry/getstream.xml  |  8 ++++++++
 2 files changed, 34 insertions(+)

diff --git a/reference/rar/functions/rar-close.xml b/reference/rar/functions/rar-close.xml
index 6c8fe8144d..df7535da01 100644
--- a/reference/rar/functions/rar-close.xml
+++ b/reference/rar/functions/rar-close.xml
@@ -39,6 +39,32 @@
    &return.success;
   </para>
  </refsect1>
+ 
+  <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>2.0.0</entry>
+       <entry>
+        The Rar entries returned by <function>rar_entry_get</function>
+		and <function>rar_list</function> are now invalidated when
+		calling <function>rar_close</function>.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
 
 </refentry>
 
diff --git a/reference/rar/rarentry/getstream.xml b/reference/rar/rarentry/getstream.xml
index 297cbc5154..626378682b 100644
--- a/reference/rar/rarentry/getstream.xml
+++ b/reference/rar/rarentry/getstream.xml
@@ -20,6 +20,10 @@
    supports read operations. This handler provides on-the-fly decompression
    for this entry.
   </para>
+  <para>
+	The handler is not invalidated by calling
+	<function>rar_close</function>.
+  </para>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -49,6 +53,8 @@ if ($entry === false)
 $stream = $entry->getStream();
 if ($stream === false)
     die("Failed to obtain stream.");
+	
+rar_close($rar_file); //stream is independent from file
 
 while (!feof($stream)) {
 	$buff = fread($stream, 8192);
@@ -58,6 +64,8 @@ while (!feof($stream)) {
 		break; //fread error
 }
 
+fclose($stream);
+
 ?>
 ]]>
     </programlisting>