nlopess Thu Jan 18 17:02:24 2007 UTC
Modified files:
/phpdoc/en/reference/exec/functions proc-open.xml
Log:
document bypass_shell option
comment the pty docs, as the code was disabled on php sources for a loong time
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/exec/functions/proc-open.xml?r1=1.14&r2=1.15&diff_format=u
Index: phpdoc/en/reference/exec/functions/proc-open.xml
diff -u phpdoc/en/reference/exec/functions/proc-open.xml:1.14
phpdoc/en/reference/exec/functions/proc-open.xml:1.15
--- phpdoc/en/reference/exec/functions/proc-open.xml:1.14 Sun Feb 27
12:33:11 2005
+++ phpdoc/en/reference/exec/functions/proc-open.xml Thu Jan 18 17:02:24 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.14 $ -->
+<!-- $Revision: 1.15 $ -->
<!-- splitted from ./en/functions/exec.xml, last change in rev 1.28 -->
<refentry id='function.proc-open'>
<refnamediv>
@@ -23,6 +23,8 @@
<function>proc_open</function> is similar to <function>popen</function>
but provides a much greater degree of control over the program execution.
</para>
+
+<!-- ptys are currently disabled in the sources
<para>
PHP 5 introduces pty support for systems with Unix98 ptys. This allows
your script to interact with applications that expect to be talking to a
@@ -33,6 +35,8 @@
times. In a future version of PHP, it might be possible to do more than
just read and write to the pty.
</para>
+-->
+
</refsect1>
<refsect1 role="parameters">
@@ -56,8 +60,8 @@
process. 0 is stdin, 1 is stdout, while 2 is stderr.
</para>
<para>
- The currently supported pipe types are <literal>file</literal>,
- <literal>pipe</literal> and <literal>pty</literal>.
+ The currently supported pipe types are <literal>file</literal> and
+ <literal>pipe</literal> <!-- and <literal>pty</literal>-->.
</para>
<para>
The file descriptor numbers are not limited to 0, 1 and 2 - you may
@@ -103,9 +107,18 @@
<term><parameter>other_options</parameter></term>
<listitem>
<para>
- Allows you to specify additional options. Currently only
- <literal>suppress_errors</literal> is supported, which suppresses
- errors generated by this function when it's set to &true;
+ Allows you to specify additional options. Currently supported options
+ include:
+ <simplelist>
+ <member>
+ <literal>suppress_errors</literal> (windows only): suppresses errors
+ generated by this function when it's set to &true;
+ </member>
+ <member>
+ <literal>bypass_shell</literal> (windows only): bypass
+ <literal>cmd.exe</literal> shell when set to &true;
+ </member>
+ </simplelist>
</para>
</listitem>
</varlistentry>
@@ -135,11 +148,17 @@
</thead>
<tbody>
<row>
+ <entry>5.2.1.</entry>
+ <entry>
+ Added the <literal>bypass_shell</literal> option to the
+ <parameter>other_options</parameter> parameter.
+ </entry>
+ </row>
+ <row>
<entry>5.0.0.</entry>
<entry>
Added the <parameter>cwd</parameter>, <parameter>env</parameter> and
- <parameter>other_options</parameter> parameters. Added support for
- Unix98 ptys.
+ <parameter>other_options</parameter> parameters.
</entry>
</row>
</tbody>
@@ -203,6 +222,8 @@
</screen>
</example>
</para>
+
+<!-- ptys are currently disabled
<para>
<example>
<title>ptys usage</title>
@@ -224,6 +245,8 @@
</programlisting>
</example>
</para>
+-->
+
</refsect1>
<refsect1 role="notes">
