From bd6fe5c1ebe69bf507bf1ee6f1a88168ea02f874 Mon Sep 17 00:00:00 2001
From: Michael Spector <michael@php.net>
Date: Sun, 2 Oct 2005 07:41:34 +0000
Subject: [PATCH] add expect:// wrapper notes

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@197331 c90b9560-bf6c-de11-be94-00142212c4b1
---
 appendices/wrappers.xml | 82 ++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 81 insertions(+), 1 deletion(-)

diff --git a/appendices/wrappers.xml b/appendices/wrappers.xml
index e19b933cbb..a47c5a1dfb 100644
--- a/appendices/wrappers.xml
+++ b/appendices/wrappers.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.56 $ -->
+<!-- $Revision: 1.57 $ -->
 <appendix id="wrappers">
  <title>List of Supported Protocols/Wrappers</title>
  <para>
@@ -1209,6 +1209,86 @@ $stream = fopen("ssh2.tunnel://$session/remote.example.com:1234", 'r');
   </para>
  </section>
 
+
+ <section id="wrappers.expect">
+  <title>Process Interaction Streams</title>
+  <simpara><filename>expect://</filename> PHP 4.3.0 and up (PECL) </simpara>
+
+  <itemizedlist>
+   <listitem><simpara><filename>expect://command</filename></simpara></listitem>
+  </itemizedlist>
+
+  <note>
+   <title>This wrapper is not enabled by default</title>
+   <simpara>
+    In order to use the <filename>expect://</filename> wrapper you must install
+    the <ulink url="&url.pecl.package;expect">Expect</ulink> extension
+    available from <ulink url="&url.pecl;">PECL</ulink>.
+   </simpara>
+  </note>
+
+  <simpara>
+   Streams opened via the <filename>expect://</filename> wrapper provide
+   access to process'es stdio, stdout and stderr via PTY.
+  </simpara>
+
+  <para>
+   <table>
+    <title>Wrapper Summary</title>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>Attribute</entry>
+       <entry>Supported</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>Restricted by <link linkend="ini.allow-url-fopen">allow_url_fopen</link>.</entry>
+       <entry>No</entry>
+      </row>
+      <row>
+       <entry>Allows Reading</entry>
+       <entry>Yes</entry>
+      </row>
+      <row>
+       <entry>Allows Writing</entry>
+       <entry>Yes</entry>
+      </row>
+      <row>
+       <entry>Allows Appending</entry>
+       <entry>Yes</entry>
+      </row>
+      <row>
+       <entry>Allows Simultaneous Reading and Writing</entry>
+       <entry>No</entry>
+      </row>
+      <row>
+       <entry>Supports <function>stat</function></entry>
+       <entry>No</entry>
+      </row>
+      <row>
+       <entry>Supports <function>unlink</function></entry>
+       <entry>No</entry>
+      </row>
+      <row>
+       <entry>Supports <function>rename</function></entry>
+       <entry>No</entry>
+      </row>
+      <row>
+       <entry>Supports <function>mkdir</function></entry>
+       <entry>No</entry>
+      </row>
+      <row>
+       <entry>Supports <function>rmdir</function></entry>
+       <entry>No</entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </table>
+  </para>
+ </section>
+
 </appendix>
 
 <!-- Keep this comment at the end of the file