[PHP-DOC] cvs: phpdoc /en/reference/expect .cvsignore configure.xml constants.xml ini.xml

2005-10-02 Thread Michael Spector
michael Sun Oct  2 02:53:45 2005 EDT

  Added files: 
/phpdoc/en/reference/expect .cvsignore configure.xml constants.xml 
ini.xml 
  Log:
  start writting documentation for expect
  
  

http://cvs.php.net/co.php/phpdoc/en/reference/expect/.cvsignore?r=1.1p=1
Index: phpdoc/en/reference/expect/.cvsignore
+++ phpdoc/en/reference/expect/.cvsignore
functions.xml

http://cvs.php.net/co.php/phpdoc/en/reference/expect/configure.xml?r=1.1p=1
Index: phpdoc/en/reference/expect/configure.xml
+++ phpdoc/en/reference/expect/configure.xml
?xml version=1.0 encoding=iso-8859-1?
!-- $Revision: 1.1 $ --
section id=expect.installation
 reftitle.install;
 para
  pecl.moved;
  pecl.info;
  ulink url=url.pecl.package;expecturl.pecl.package;expect/ulink.
 /para
 para
  pecl.source.4;
  In order to use these functions you must compile PHP with expect support
  by using the option role=configure--with-expect[=DIR]/option 
  configure option.
 /para
 para
  Windows users will enable filenamephp_expect.dll/filename inside
  of php.ini; in order to use these functions.
  pecl.windows.4;
  pecl.windows.download;
 /para
/section

!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:../../../manual.ced
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
--


http://cvs.php.net/co.php/phpdoc/en/reference/expect/constants.xml?r=1.1p=1
Index: phpdoc/en/reference/expect/constants.xml
+++ phpdoc/en/reference/expect/constants.xml
?xml version='1.0' encoding='iso-8859-1'?
!-- $Revision: 1.1 $ --
section id=expect.constants
 reftitle.constants;
 extension.constants;
 variablelist
  varlistentry
   term
constantEXP_GLOB/constant
 (typeinteger/type)
   /term
   listitem
simpara
 Indicates that the pattern is a glob-style string pattern.
/simpara
   /listitem
  /varlistentry
  varlistentry
   term
constantEXP_EXACT/constant
 (typeinteger/type)
   /term
   listitem
simpara
 Indicates that the pattern is an exact string.
/simpara
   /listitem
  /varlistentry
  varlistentry
   term
constantEXP_REGEXP/constant
 (typeinteger/type)
   /term
   listitem
simpara
 Indicates that the pattern is a regexp-style string pattern.
/simpara
   /listitem
  /varlistentry
  varlistentry
   term
constantEXP_EOF/constant
 (typeinteger/type)
   /term
   listitem
simpara
 Value, returned by functionexpect_expectl/function, when EOF is
 reached.
/simpara
   /listitem
  /varlistentry
  varlistentry
   term
constantEXP_TIMEOUT/constant
 (typeinteger/type)
   /term
   listitem
simpara
 Value, returned by functionexpect_expectl/function upon timeout.
/simpara
   /listitem
  /varlistentry
  varlistentry
   term
constantEXP_FULLBUFFER/constant
 (typeinteger/type)
   /term
   listitem
simpara
 Value, returned by functionexpect_expectl/function if no pattern have
 been matched.
/simpara
   /listitem
  /varlistentry
 /variablelist
/section

!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:../../../../manual.ced
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
--

http://cvs.php.net/co.php/phpdoc/en/reference/expect/ini.xml?r=1.1p=1
Index: phpdoc/en/reference/expect/ini.xml
+++ phpdoc/en/reference/expect/ini.xml
?xml version=1.0 encoding=iso-8859-1?
!-- $Revision: 1.1 $ --
section id=expect.configuration
 reftitle.runtime;
 extension.runtime;
 para
  In order to configure expect extension, there are configuration options
  in the link linkend=configuration.fileconfiguration file/link php.ini;.
   table
   titleExpect Configuration Options/title
   tgroup cols=4
thead
 row
  entryName/entry
  entryDefault/entry
  entryChangeable/entry
 /row
/thead
tbody
 row
  entryexpect.timeout/entry
  entry10/entry
  entryPHP_INI_ALL/entry
 /row
 row
  entryexpect.loguser/entry
  entryOn/entry
  entryPHP_INI_ALL/entry
 /row
 row
  entryexpect.logfile/entry
  entry/entry
  entryPHP_INI_ALL/entry
 /row
/tbody
   /tgroup
  /table
   ini.php.constants;
/para
 
 ini.descriptions.title;
 
 para
 variablelist
  varlistentry id=ini.expect.timeout
   term
parameterexpect.timeout/parameter
typeinteger/type
   /term
   listitem
para
The timeout period for waiting for the data, 

[PHP-DOC] cvs: phpdoc /entities global.ent

2005-10-02 Thread Michael Spector
michael Sun Oct  2 03:00:17 2005 EDT

  Modified files:  
/phpdoc/entitiesglobal.ent 
  Log:
  added URL for libexpect
  
  
http://cvs.php.net/diff.php/phpdoc/entities/global.ent?r1=1.244r2=1.245ty=u
Index: phpdoc/entities/global.ent
diff -u phpdoc/entities/global.ent:1.244 phpdoc/entities/global.ent:1.245
--- phpdoc/entities/global.ent:1.244Sun Sep 25 11:28:22 2005
+++ phpdoc/entities/global.ent  Sun Oct  2 03:00:15 2005
@@ -1,6 +1,6 @@
 !-- -*- SGML -*-
 
- $Id: global.ent,v 1.244 2005/09/25 15:28:22 nlopess Exp $
+ $Id: global.ent,v 1.245 2005/10/02 07:00:15 michael Exp $
 
  Contains global macros for all the XML documents.
 
@@ -80,6 +80,7 @@
 !ENTITY url.exifspec http://exif.org/Exif2-2.PDF;
 !ENTITY url.expat http://www.jclark.com/xml/expat.html;
 !ENTITY url.expat.rpm http://sourceforge.net/projects/expat/;
+!ENTITY url.expect http://expect.nist.gov/;
 !ENTITY url.exslt http://www.exslt.org/;
 !ENTITY url.exsltlib http://xmlsoft.org/XSLT/EXSLT/index.html;
 !ENTITY url.ezweb http://www.au.kddi.com/english/ezweb/;


[PHP-DOC] cvs: phpdoc /en/reference/expect reference.xml

2005-10-02 Thread Michael Spector
michael Sun Oct  2 03:31:54 2005 EDT

  Added files: 
/phpdoc/en/reference/expect reference.xml 
  Log:
  add note about using expect wrapper
  
  

http://cvs.php.net/co.php/phpdoc/en/reference/expect/reference.xml?r=1.1p=1
Index: phpdoc/en/reference/expect/reference.xml
+++ phpdoc/en/reference/expect/reference.xml
?xml version=1.0 encoding=iso-8859-1?
!-- $Revision: 1.1 $ --
!-- Purpose: system --
!-- Membership: pecl --

 reference id=ref.expect
  titleExpect Functions/title
  titleabbrevExpect/titleabbrev

  partintro
   section id=expect.intro
reftitle.intro;
para
 This extension allows to interact with processes through PTY. You may
 consider using the link 
linkend=wrappers.expectliteralexpect:///literal
 wrapper/link with the link linkend=ref.filesystemfilesystem
 functions/link which provide a simpler and more intuitive interface.
/para
   /section
   
   section id=expect.requirements
reftitle.required;
para
 This module uses the functions of the ulink
 url=url.expect;expect/ulink library.
 You need libexpect version gt;= 5.43.0.
/para
   /section
   
   reference.expect.configure;

   reference.expect.ini;

   section id=expect.resources
reftitle.resources;
no.resource;
   /section

   reference.expect.constants;

   section id=expect.examples
reftitle.examples;
para
 This example connects to the remote host via SSH, and prints the remote
 uptime.
/para
example
 titleExpect Usage Example/title
 programlisting role=php
![CDATA[
?php

ini_set (expect.loguser, Off);

$fp = expect_popen (ssh [EMAIL PROTECTED] uptime);

$cases = array (
  array (0 = password:, 1 = PASSWORD)
);

switch (expect_expectl ($fp, $cases))
{
 case PASSWORD:
  fwrite ($fp, password\n);
  break;
 
 default:
  die (Error was occurred while connecting to the remote host!\n);
}

while ($line = fgets ($fp)) {
  print $line;
}
fclose ($fp);

?
]]
 /programlisting
/example
   /section
  /partintro

reference.expect.functions;

 /reference
!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:../../../manual.ced
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
--


[PHP-DOC] cvs: phpdoc /en/appendices wrappers.xml

2005-10-02 Thread Michael Spector
michael Sun Oct  2 03:41:36 2005 EDT

  Modified files:  
/phpdoc/en/appendices   wrappers.xml 
  Log:
  add expect:// wrapper notes
  
  
http://cvs.php.net/diff.php/phpdoc/en/appendices/wrappers.xml?r1=1.56r2=1.57ty=u
Index: phpdoc/en/appendices/wrappers.xml
diff -u phpdoc/en/appendices/wrappers.xml:1.56 
phpdoc/en/appendices/wrappers.xml:1.57
--- phpdoc/en/appendices/wrappers.xml:1.56  Wed Sep 21 14:21:59 2005
+++ phpdoc/en/appendices/wrappers.xml   Sun Oct  2 03:41:34 2005
@@ -1,5 +1,5 @@
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.56 $ --
+!-- $Revision: 1.57 $ --
 appendix id=wrappers
  titleList of Supported Protocols/Wrappers/title
  para
@@ -1209,6 +1209,86 @@
   /para
  /section
 
+
+ section id=wrappers.expect
+  titleProcess Interaction Streams/title
+  simparafilenameexpect:///filename PHP 4.3.0 and up (PECL) /simpara
+
+  itemizedlist
+   
listitemsimparafilenameexpect://command/filename/simpara/listitem
+  /itemizedlist
+
+  note
+   titleThis wrapper is not enabled by default/title
+   simpara
+In order to use the filenameexpect:///filename wrapper you must install
+the ulink url=url.pecl.package;expectExpect/ulink extension
+available from ulink url=url.pecl;PECL/ulink.
+   /simpara
+  /note
+
+  simpara
+   Streams opened via the filenameexpect:///filename wrapper provide
+   access to process'es stdio, stdout and stderr via PTY.
+  /simpara
+
+  para
+   table
+titleWrapper Summary/title
+tgroup cols=2
+ thead
+  row
+   entryAttribute/entry
+   entrySupported/entry
+  /row
+ /thead
+ tbody
+  row
+   entryRestricted by link 
linkend=ini.allow-url-fopenallow_url_fopen/link./entry
+   entryNo/entry
+  /row
+  row
+   entryAllows Reading/entry
+   entryYes/entry
+  /row
+  row
+   entryAllows Writing/entry
+   entryYes/entry
+  /row
+  row
+   entryAllows Appending/entry
+   entryYes/entry
+  /row
+  row
+   entryAllows Simultaneous Reading and Writing/entry
+   entryNo/entry
+  /row
+  row
+   entrySupports functionstat/function/entry
+   entryNo/entry
+  /row
+  row
+   entrySupports functionunlink/function/entry
+   entryNo/entry
+  /row
+  row
+   entrySupports functionrename/function/entry
+   entryNo/entry
+  /row
+  row
+   entrySupports functionmkdir/function/entry
+   entryNo/entry
+  /row
+  row
+   entrySupports functionrmdir/function/entry
+   entryNo/entry
+  /row
+ /tbody
+/tgroup
+   /table
+  /para
+ /section
+
 /appendix
 
 !-- Keep this comment at the end of the file


[PHP-DOC] cvs: phpdoc /en/reference/expect/functions expect-popen.ini

2005-10-02 Thread Michael Spector
michael Sun Oct  2 03:45:28 2005 EDT

  Added files: 
/phpdoc/en/reference/expect/functions   expect-popen.ini 
  Log:
  describe function expect_popen
  
  

http://cvs.php.net/co.php/phpdoc/en/reference/expect/functions/expect-popen.ini?r=1.1p=1
Index: phpdoc/en/reference/expect/functions/expect-popen.ini
+++ phpdoc/en/reference/expect/functions/expect-popen.ini
?xml version=1.0 encoding=iso-8859-1?
!-- $Revision: 1.1 $ --
refentry id=function.expect-popen
 refnamediv
  refnameexpect_popen/refname
  refpurposeExectutes command via Bourne shell./refpurpose
 /refnamediv
 refsect1 role=description
  reftitle.description;
  methodsynopsis
   typeresource/typemethodnameexpect_popen/methodname
   methodparamtypestring/typeparametercommand/parameter/methodparam
  /methodsynopsis
  para
   Executes command via Bourne shell.
  /para
 /refsect1
 refsect1 role=parameters
  reftitle.parameters;
  para
   variablelist
varlistentry
 termparametercommand/parameter/term
 listitem
  para
   Command to execute.
  /para
 /listitem
/varlistentry
   /variablelist
  /para
 /refsect1
 refsect1 role=returnvalues
  reftitle.returnvalues;
  para
   Returns an open PTY stream to the process'es stdio, stdout and stderr.
  /para
  para
   On failure this function returns false;.
  /para
 /refsect1
 refsect1 role=seealso
  reftitle.seealso;
  para
   simplelist
memberfunctionfopen/function/member
   /simplelist
  /para
 /refsect1
/refentry

!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:../../../../manual.ced
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
--


[PHP-DOC] cvs: phpdoc /en/reference/expect/functions expect-popen.ini

2005-10-02 Thread Michael Spector
michael Sun Oct  2 03:47:12 2005 EDT

  Modified files:  
/phpdoc/en/reference/expect/functions   expect-popen.ini 
  Log:
  typo fix
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/expect/functions/expect-popen.ini?r1=1.1r2=1.2ty=u
Index: phpdoc/en/reference/expect/functions/expect-popen.ini
diff -u phpdoc/en/reference/expect/functions/expect-popen.ini:1.1 
phpdoc/en/reference/expect/functions/expect-popen.ini:1.2
--- phpdoc/en/reference/expect/functions/expect-popen.ini:1.1   Sun Oct  2 
03:45:27 2005
+++ phpdoc/en/reference/expect/functions/expect-popen.ini   Sun Oct  2 
03:47:09 2005
@@ -1,5 +1,5 @@
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.1 $ --
+!-- $Revision: 1.2 $ --
 refentry id=function.expect-popen
  refnamediv
   refnameexpect_popen/refname
@@ -43,7 +43,7 @@
   reftitle.seealso;
   para
simplelist
-memberfunctionfopen/function/member
+memberfunctionpopen/function/member
/simplelist
   /para
  /refsect1


[PHP-DOC] cvs: phpdoc /en/reference/expect/functions expect-popen.ini

2005-10-02 Thread Michael Spector
michael Sun Oct  2 04:00:52 2005 EDT

  Removed files:   
/phpdoc/en/reference/expect/functions   expect-popen.ini 
  Log:
  filename was wrong
  
  


[PHP-DOC] cvs: phpdoc /en/reference/expect/functions expect-expectl.xml expect-popen.xml

2005-10-02 Thread Michael Spector
michael Sun Oct  2 04:20:53 2005 EDT

  Added files: 
/phpdoc/en/reference/expect/functions   expect-expectl.xml 
expect-popen.xml 
  Log:
  functions
  
  

http://cvs.php.net/co.php/phpdoc/en/reference/expect/functions/expect-expectl.xml?r=1.1p=1
Index: phpdoc/en/reference/expect/functions/expect-expectl.xml
+++ phpdoc/en/reference/expect/functions/expect-expectl.xml
?xml version=1.0 encoding=iso-8859-1?
!-- $Revision: 1.1 $ --
refentry id=function.expect-expectl
 refnamediv
  refnameexpect_expectl/refname
  refpurposeWaits until the output from a process matches one
  of the patterns, a specified time period has passed, or an EOF is seen.
  /refpurpose
 /refnamediv
 refsect1 role=description
  reftitle.description;
  methodsynopsis
   typeresource/typemethodnameexpect_expectl/methodname
   methodparamtyperesource/typeparameterexpect/parameter/methodparam
   methodparamtypearray/typeparametercases/parameter/methodparam
  /methodsynopsis
  para
   Waits until the output from a process matches one of the patterns,
   a specified time period has passed, or an EOF is seen.
  /para
 /refsect1
 refsect1 role=parameters
  reftitle.parameters;
  para
   variablelist
varlistentry
 termparameterexpect/parameter/term
 listitem
  para
   An Expect stream, previously opened with
   functionexpect_popen/function.
  /para
 /listitem
/varlistentry
varlistentry
 termparametercases/parameter/term
 listitem
  para
   An array of expect cases. Each expect case is an indexed array, where
   value corresponding to key 0 is a string pattern, 1 - return value, 
   and 2 - one of EXP_GLOB, EXP_EXACT or EXP_REGEXP (pattern type).

   Key index 2 is optional, if not specified - the value of EXP_GLOB is
   used by default.
  /para
 /listitem
/varlistentry
   /variablelist
  /para
 /refsect1
 refsect1 role=returnvalues
  reftitle.returnvalues;
  para
   Returns value associated with pattern that was matched.
  /para
  para
   On failure this function returns EXP_EOF, EXP_TIMEOUT or EXP_FULLBUFFER.
  /para
 /refsect1
 refsect1 role=examples
  reftitle.examples;
  para
   example
titlefunctionexpect_expectl/function example/title
programlisting role=php
![CDATA[
?php
// Copies file from remote host:
ini_set (expect.timeout, 30);

$stream = popen (expect://scp [EMAIL PROTECTED]:/var/log/messages 
/home/user/messages.txt, r);

$cases = array (
  array (0 = password:, 1 = PASSWORD),
  array (0 = yes/no)?, 1 = YESNO)
);

while (true) {
 switch (expect_expectl ($stream, $cases))
 {
  case PASSWORD:
   fwrite ($stream, password\n);
   break;

  case YESNO:
   fwrite ($stream, yes\n);
   break;

  case EXP_TIMEOUT:
  case EXP_EOF:
   break 2;
  
  default:
   die (Error has occurred!\n);
 }
}

fclose ($stream);
?
]]
/programlisting
   /example
  /para
 /refsect1
 refsect1 role=seealso
  reftitle.seealso;
  para
   simplelist
memberfunctionexpect_popen/function/member
   /simplelist
  /para
 /refsect1
/refentry

!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:../../../../manual.ced
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
--

http://cvs.php.net/co.php/phpdoc/en/reference/expect/functions/expect-popen.xml?r=1.1p=1
Index: phpdoc/en/reference/expect/functions/expect-popen.xml
+++ phpdoc/en/reference/expect/functions/expect-popen.xml
?xml version=1.0 encoding=iso-8859-1?
!-- $Revision: 1.1 $ --
refentry id=function.expect-popen
 refnamediv
  refnameexpect_popen/refname
  refpurposeExectutes command via Bourne shell./refpurpose
 /refnamediv
 refsect1 role=description
  reftitle.description;
  methodsynopsis
   typeresource/typemethodnameexpect_popen/methodname
   methodparamtypestring/typeparametercommand/parameter/methodparam
  /methodsynopsis
  para
   Executes command via Bourne shell.
  /para
 /refsect1
 refsect1 role=parameters
  reftitle.parameters;
  para
   variablelist
varlistentry
 termparametercommand/parameter/term
 listitem
  para
   Command to execute.
  /para
 /listitem
/varlistentry
   /variablelist
  /para
 /refsect1
 refsect1 role=returnvalues
  reftitle.returnvalues;
  para
   Returns an open PTY stream to the process'es stdio, stdout and stderr.
  /para
  para
   On failure this function returns false;.
  /para
 /refsect1
 refsect1 role=examples
  reftitle.examples;
  para
   example
titlefunctionexpect_popen/function example/title
programlisting role=php
![CDATA[
?php
// Login to the PHP.net CVS repository:
$stream = expect_popen (cvs -d :pserver:[EMAIL PROTECTED]:/repository 

[PHP-DOC] cvs: phpdoc /en/appendices extensions.xml

2005-10-02 Thread Michael Spector
michael Sun Oct  2 04:27:25 2005 EDT

  Modified files:  
/phpdoc/en/appendices   extensions.xml 
  Log:
  added 'expect' and 'newt' extensions
  
  
http://cvs.php.net/diff.php/phpdoc/en/appendices/extensions.xml?r1=1.14r2=1.15ty=u
Index: phpdoc/en/appendices/extensions.xml
diff -u phpdoc/en/appendices/extensions.xml:1.14 
phpdoc/en/appendices/extensions.xml:1.15
--- phpdoc/en/appendices/extensions.xml:1.14Sun Sep 18 08:08:21 2005
+++ phpdoc/en/appendices/extensions.xml Sun Oct  2 04:27:24 2005
@@ -1,5 +1,5 @@
 ?xml version=1.0 encoding=utf-8?
-!-- $Revision: 1.14 $ --
+!-- $Revision: 1.15 $ --
 !--
   DO NOT TRANSLATE THIS FILE! All the content that is displayed
   on the extension categorization page in your translated manual
@@ -233,6 +233,7 @@
 
 itemizedlist
  listitemparaxref linkend=ref.exec//para/listitem
+ listitemparaxref linkend=ref.expect//para/listitem
  listitemparaxref linkend=ref.pcntl//para/listitem
  listitemparaxref linkend=ref.posix//para/listitem
  listitemparaxref linkend=ref.sem//para/listitem
@@ -355,6 +356,7 @@
 
 itemizedlist
  listitemparaxref linkend=ref.ncurses//para/listitem
+ listitemparaxref linkend=ref.newt//para/listitem
  listitemparaxref linkend=ref.readline//para/listitem
 /itemizedlist
/section
@@ -602,6 +604,7 @@
 listitemparaxref linkend=ref.dbx//para/listitem
 listitemparaxref linkend=ref.dio//para/listitem
 listitemparaxref linkend=ref.domxml//para/listitem
+listitemparaxref linkend=ref.expect//para/listitem
 listitemparaxref linkend=ref.fam//para/listitem
 listitemparaxref linkend=ref.fribidi//para/listitem
 listitemparaxref linkend=ref.hw//para/listitem
@@ -621,6 +624,7 @@
 listitemparaxref linkend=ref.mnogosearch//para/listitem
 listitemparaxref linkend=ref.muscat//para/listitem
 listitemparaxref linkend=ref.net-gopher//para/listitem
+listitemparaxref linkend=ref.newt//para/listitem
 listitemparaxref linkend=ref.nis//para/listitem
 listitemparaxref linkend=ref.notes//para/listitem
 listitemparaxref linkend=ref.oggvorbis//para/listitem


[PHP-DOC] cvs: phpdoc /en/reference/expect/functions expect-expectl.xml

2005-10-02 Thread Michael Spector
michael Sun Oct  2 04:33:41 2005 EDT

  Modified files:  
/phpdoc/en/reference/expect/functions   expect-expectl.xml 
  Log:
  fix return type
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/expect/functions/expect-expectl.xml?r1=1.1r2=1.2ty=u
Index: phpdoc/en/reference/expect/functions/expect-expectl.xml
diff -u phpdoc/en/reference/expect/functions/expect-expectl.xml:1.1 
phpdoc/en/reference/expect/functions/expect-expectl.xml:1.2
--- phpdoc/en/reference/expect/functions/expect-expectl.xml:1.1 Sun Oct  2 
04:20:49 2005
+++ phpdoc/en/reference/expect/functions/expect-expectl.xml Sun Oct  2 
04:33:39 2005
@@ -1,5 +1,5 @@
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.1 $ --
+!-- $Revision: 1.2 $ --
 refentry id=function.expect-expectl
  refnamediv
   refnameexpect_expectl/refname
@@ -10,7 +10,7 @@
  refsect1 role=description
   reftitle.description;
   methodsynopsis
-   typeresource/typemethodnameexpect_expectl/methodname
+   typemixed/typemethodnameexpect_expectl/methodname

methodparamtyperesource/typeparameterexpect/parameter/methodparam
methodparamtypearray/typeparametercases/parameter/methodparam
   /methodsynopsis


[PHP-DOC] Notes Status, 13047 total

2005-10-02 Thread phpdoc
Following are the top 20 pages of the manual, sorted by the number
of user notes contributed. These sections could use a polish, those
notes represent 8.6% of the 13047 total user notes.

Notes  |  Page
---+-
   74  | http://php.net/manual/en/function.header.php
   69  | http://php.net/manual/en/function.preg-replace.php
   61  | http://php.net/manual/en/ref.image.php
   61  | http://php.net/manual/en/features.file-upload.php
   59  | http://php.net/manual/en/function.date.php
   59  | http://php.net/manual/en/ref.xml.php
   57  | http://php.net/manual/en/function.mktime.php
   56  | http://php.net/manual/en/function.time.php
   56  | http://php.net/manual/en/function.fopen.php
   56  | http://php.net/manual/en/ref.com.php
   55  | http://php.net/manual/en/function.mssql-connect.php
   54  | http://php.net/manual/en/function.readdir.php
   54  | http://php.net/manual/en/function.eval.php
   54  | http://php.net/manual/en/function.fsockopen.php
   54  | http://php.net/manual/en/reserved.variables.php
   53  | http://php.net/manual/en/function.md5.php
   50  | http://php.net/manual/en/function.str-replace.php
   48  | http://php.net/manual/en/ref.datetime.php
   48  | http://php.net/manual/en/ref.mail.php
   47  | http://php.net/manual/en/ref.session.php


[PHP-DOC] #34706 [NEW]: Confusing socket_bind() documentation

2005-10-02 Thread garmoan at gmail dot com
From: garmoan at gmail dot com
Operating system: 
PHP version:  Irrelevant
PHP Bug Type: Documentation problem
Bug description:  Confusing socket_bind() documentation

Description:

As suggested by aidan to do...

The socket_bind() documentation could do with a couple extra lines to
explain what it actually does.

i.e. socket_bind(), in terms of AF_INET, opens the port on the specified
address, and in terms of AF_UNIX, creates the *.sock file for
inter-process communication.


-- 
Edit bug report at http://bugs.php.net/?id=34706edit=1
-- 
Try a CVS snapshot (php4):   http://bugs.php.net/fix.php?id=34706r=trysnapshot4
Try a CVS snapshot (php5.0): 
http://bugs.php.net/fix.php?id=34706r=trysnapshot50
Try a CVS snapshot (php5.1): 
http://bugs.php.net/fix.php?id=34706r=trysnapshot51
Fixed in CVS:http://bugs.php.net/fix.php?id=34706r=fixedcvs
Fixed in release:http://bugs.php.net/fix.php?id=34706r=alreadyfixed
Need backtrace:  http://bugs.php.net/fix.php?id=34706r=needtrace
Need Reproduce Script:   http://bugs.php.net/fix.php?id=34706r=needscript
Try newer version:   http://bugs.php.net/fix.php?id=34706r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=34706r=support
Expected behavior:   http://bugs.php.net/fix.php?id=34706r=notwrong
Not enough info: 
http://bugs.php.net/fix.php?id=34706r=notenoughinfo
Submitted twice: 
http://bugs.php.net/fix.php?id=34706r=submittedtwice
register_globals:http://bugs.php.net/fix.php?id=34706r=globals
PHP 3 support discontinued:  http://bugs.php.net/fix.php?id=34706r=php3
Daylight Savings:http://bugs.php.net/fix.php?id=34706r=dst
IIS Stability:   http://bugs.php.net/fix.php?id=34706r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=34706r=gnused
Floating point limitations:  http://bugs.php.net/fix.php?id=34706r=float
No Zend Extensions:  http://bugs.php.net/fix.php?id=34706r=nozend
MySQL Configuration Error:   http://bugs.php.net/fix.php?id=34706r=mysqlcfg


[PHP-DOC] #34706 [Opn]: Confusing socket_bind() documentation

2005-10-02 Thread simp
 ID:  34706
 Updated by:  [EMAIL PROTECTED]
 Reported By: garmoan at gmail dot com
 Status:  Open
 Bug Type:Documentation problem
 PHP Version: Irrelevant
 New Comment:

Actually that's not what the function does. It assigns the address and
port to a unbound socket. 
Opening the connection is still left for socket_listen or
socket_connect.


Previous Comments:


[2005-10-02 15:09:41] garmoan at gmail dot com

Description:

As suggested by aidan to do...

The socket_bind() documentation could do with a couple extra lines to
explain what it actually does.

i.e. socket_bind(), in terms of AF_INET, opens the port on the
specified address, and in terms of AF_UNIX, creates the *.sock file for
inter-process communication.






-- 
Edit this bug report at http://bugs.php.net/?id=34706edit=1


[PHP-DOC] #34706 [Opn-Asn]: Confusing socket_bind() documentation

2005-10-02 Thread simp
 ID:  34706
 Updated by:  [EMAIL PROTECTED]
 Reported By: garmoan at gmail dot com
-Status:  Open
+Status:  Assigned
 Bug Type:Documentation problem
 PHP Version: Irrelevant
-Assigned To: 
+Assigned To: simp


Previous Comments:


[2005-10-02 15:34:12] [EMAIL PROTECTED]

Actually that's not what the function does. It assigns the address and
port to a unbound socket. 
Opening the connection is still left for socket_listen or
socket_connect.



[2005-10-02 15:09:41] garmoan at gmail dot com

Description:

As suggested by aidan to do...

The socket_bind() documentation could do with a couple extra lines to
explain what it actually does.

i.e. socket_bind(), in terms of AF_INET, opens the port on the
specified address, and in terms of AF_UNIX, creates the *.sock file for
inter-process communication.






-- 
Edit this bug report at http://bugs.php.net/?id=34706edit=1


[PHP-DOC] cvs: phpdoc /en/reference/sockets/functions socket-bind.xml

2005-10-02 Thread Oliver Albers
simpSun Oct  2 10:49:54 2005 EDT

  Modified files:  
/phpdoc/en/reference/sockets/functions  socket-bind.xml 
  Log:
  Bug #34706: Added note to establish the connection using other functions
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/sockets/functions/socket-bind.xml?r1=1.9r2=1.10ty=u
Index: phpdoc/en/reference/sockets/functions/socket-bind.xml
diff -u phpdoc/en/reference/sockets/functions/socket-bind.xml:1.9 
phpdoc/en/reference/sockets/functions/socket-bind.xml:1.10
--- phpdoc/en/reference/sockets/functions/socket-bind.xml:1.9   Thu Feb 24 
02:38:36 2005
+++ phpdoc/en/reference/sockets/functions/socket-bind.xml   Sun Oct  2 
10:49:52 2005
@@ -1,5 +1,5 @@
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.9 $ --
+!-- $Revision: 1.10 $ --
 refentry id=function.socket-bind
  refnamediv
   refnamesocket_bind/refname
@@ -16,7 +16,9 @@
   /methodsynopsis
   para
Binds the name given in parameteraddress/parameter to the socket
-   described by parametersocket/parameter.
+   described by parametersocket/parameter. This has to be done before
+   a connection can be established using functionsocket_connect/function
+   or functionsocket_listen/function.
   /para
  /refsect1
 


[PHP-DOC] #34706 [Asn-Csd]: Confusing socket_bind() documentation

2005-10-02 Thread simp
 ID:  34706
 Updated by:  [EMAIL PROTECTED]
 Reported By: garmoan at gmail dot com
-Status:  Assigned
+Status:  Closed
 Bug Type:Documentation problem
 PHP Version: Irrelevant
 Assigned To: simp
 New Comment:

This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation
better.

Binds the name given in address to the socket described by socket. This
has to be done before a connection can be established using
socket_connect or socket_listen.


Previous Comments:


[2005-10-02 15:34:12] [EMAIL PROTECTED]

Actually that's not what the function does. It assigns the address and
port to a unbound socket. 
Opening the connection is still left for socket_listen or
socket_connect.



[2005-10-02 15:09:41] garmoan at gmail dot com

Description:

As suggested by aidan to do...

The socket_bind() documentation could do with a couple extra lines to
explain what it actually does.

i.e. socket_bind(), in terms of AF_INET, opens the port on the
specified address, and in terms of AF_UNIX, creates the *.sock file for
inter-process communication.






-- 
Edit this bug report at http://bugs.php.net/?id=34706edit=1


Re: [PHP-DOC] cvs: phpdoc /en/appendices extensions.xml

2005-10-02 Thread Nuno Lopes

michael Sun Oct  2 04:27:25 2005 EDT

 Modified files:
   /phpdoc/en/appendices extensions.xml
 Log:
 added 'expect' and 'newt' extensions


This file is generated automatically, so you shouldn't add new entries by 
hand (http://doc.php.net/php/dochowto/scripts.extensions.xml.php.php).
And BTW, the newt docs aren't in CVS, so the configure is complaining about 
the missing ID.


Nuno 


[PHP-DOC] #34697 [Opn-Bgs]: Undocumented behaviour: class definition before use

2005-10-02 Thread nlopess
 ID:   34697
 Updated by:   [EMAIL PROTECTED]
 Reported By:  direvus at gmail dot com
-Status:   Open
+Status:   Bogus
 Bug Type: Documentation problem
 Operating System: Linux
 PHP Version:  Irrelevant
 New Comment:

I think it is clear enough.
It says that if you use the new PHP 5 features (interfaces,
inheritance,..) you must declare the class before using it.


Previous Comments:


[2005-10-01 03:12:54] direvus at gmail dot com

Description:

In the php5 migration guide, we have

In some cases classes must be declared before used. It only happens
only if some of the new features of PHP 5 are used. Otherwise the
behaviour is the old.

I request that this behaviour be documented properly (which features? 
And why?) in the manual chapter on Classes and Objects in PHP5.

I think for most people who are accustomed to PHP definition
conventions, this will come as a surprise.  Functions never need to be
declared before use.  Even methods within a class definition need not
be declared before use.  So why do we have this strange requirement in
the declaration of classes?

This vague mention in the migration guide really isn't sufficient ...
it's a strange and opaque behaviour whether you're migrating code or
not.






-- 
Edit this bug report at http://bugs.php.net/?id=34697edit=1


[PHP-DOC] #34702 [Opn-Bgs]: preg_* functions area of the manual

2005-10-02 Thread nlopess
 ID:   34702
 Updated by:   [EMAIL PROTECTED]
 Reported By:  ryan_huff at knl dot cc
-Status:   Open
+Status:   Bogus
 Bug Type: Documentation problem
 Operating System: Irrelevant
 PHP Version:  Irrelevant
 New Comment:

The regex syntax page provides a clean and easy reference for the
preg_* functions regex syntax.
Of course you won't be able to (easily) learn Regular Expressions from
a simple manual page. You need to buy a book about the topic. This is
not an easy subject!


Previous Comments:


[2005-10-01 20:04:49] ryan_huff at knl dot cc

Description:

As a suggestion, I would like to see the preg_* areas of the manual
re-visited someday.

The format character syntax for preg can be extremely complex to
someone who is not familiar with such, especially when it comes to the
dbl escape for the search/replace of reserved words/characters.  Then
there is knowing when you need to use the parens, or the brackets
...ect.

I feel that the manual barely explains how to use preg, even in
alien-speak.  Sure, the manual gives the definition and outlines where
all the paramiters go but doesn't explian how to use them and more
importantly, what conditions have to exist to use them. 

I think it would go along way to provide some more basic example code
on the page covering different / common use, that way the reader can
break it down in their head and apply it to their situation.

Thanks, 

MsJetEngineError

Reproduce code:
---
http://us3.php.net/manual/en/function.preg-match.php

Expected result:

A more intuitive area of the manual for the preg_* functions

Actual result:
--
A barely understandable area of the manual





-- 
Edit this bug report at http://bugs.php.net/?id=34702edit=1


[PHP-DOC] cvs: phpdoc /entities global.ent

2005-10-02 Thread Nuno Lopes
nlopess Sun Oct  2 12:46:50 2005 EDT

  Modified files:  
/phpdoc/entitiesglobal.ent 
  Log:
  update url.fribidi and url.php.release1.0.0
  
http://cvs.php.net/diff.php/phpdoc/entities/global.ent?r1=1.245r2=1.246ty=u
Index: phpdoc/entities/global.ent
diff -u phpdoc/entities/global.ent:1.245 phpdoc/entities/global.ent:1.246
--- phpdoc/entities/global.ent:1.245Sun Oct  2 03:00:15 2005
+++ phpdoc/entities/global.ent  Sun Oct  2 12:46:48 2005
@@ -1,6 +1,6 @@
 !-- -*- SGML -*-
 
- $Id: global.ent,v 1.245 2005/10/02 07:00:15 michael Exp $
+ $Id: global.ent,v 1.246 2005/10/02 16:46:48 nlopess Exp $
 
  Contains global macros for all the XML documents.
 
@@ -100,7 +100,7 @@
 !ENTITY url.freetds http://www.freetds.org/;
 !ENTITY url.freetype http://www.freetype.org/;
 !ENTITY url.freeodbc http://www.jepstone.net/FreeODBC/;
-!ENTITY url.fribidi http://fribidi.sourceforge.net/;
+!ENTITY url.fribidi http://fribidi.org/;
 !ENTITY url.gd http://www.boutell.com/gd/;
 !ENTITY url.gdbm ftp://ftp.gnu.org/pub/gnu/gdbm/;
 !ENTITY url.gentoo http://www.gentoo.org/;
@@ -279,7 +279,7 @@
 !ENTITY url.php.pear http://pear.php.net/;
 !ENTITY url.php.pear.cli http://pear.php.net/manual/en/installation.cli.php;
 !ENTITY url.php.prerelease http://qa.php.net/;
-!ENTITY url.php.release1.0.0 http://groups.google.com/[EMAIL PROTECTED]
+!ENTITY url.php.release1.0.0 
http://groups.google.com/group/comp.infosystems.www.authoring.cgi/msg/cc7d43454d64d133;
 !ENTITY url.php.release4.1.0 http://www.php.net/release_4_1_0.php;
 !ENTITY url.php.release4.2.0 http://www.php.net/release_4_2_0.php;
 !ENTITY url.php.release4.3.1 http://www.php.net/release_4_3_1.php;


[PHP-DOC] cvs: phpdoc /en/reference/win32service reference.xml

2005-10-02 Thread Jean-S�bastien Goupil
jsgoupilSun Oct  2 12:49:29 2005 EDT

  Modified files:  
/phpdoc/en/reference/win32service   reference.xml 
  Log:
  typo + word missing + WS
  
http://cvs.php.net/diff.php/phpdoc/en/reference/win32service/reference.xml?r1=1.3r2=1.4ty=u
Index: phpdoc/en/reference/win32service/reference.xml
diff -u phpdoc/en/reference/win32service/reference.xml:1.3 
phpdoc/en/reference/win32service/reference.xml:1.4
--- phpdoc/en/reference/win32service/reference.xml:1.3  Sun Sep 18 07:55:52 2005
+++ phpdoc/en/reference/win32service/reference.xml  Sun Oct  2 12:49:26 2005
@@ -1,5 +1,5 @@
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.3 $ --
+!-- $Revision: 1.4 $ --
 !-- Purpose: utilspec.windows --
 !-- Membership: pecl --
 
@@ -36,7 +36,7 @@
 /step
 step
  para
-  Copy the php_win32service.dll into you link
+  Copy the php_win32service.dll into your link
   linkend=ini.extension-dirextension_dir/link.
  /para
 /step
@@ -56,7 +56,8 @@
   section id=win32service.examples
   reftitle.examples;
para
-exampletitleRegistering a PHP to run as a service/title
+example
+ titleRegistering a PHP script to run as a service/title
  programlisting role='php'
 ![CDATA[
 ?php
@@ -71,7 +72,8 @@
 /example
/para
para
-exampletitleUnregistering a service/title
+example
+ titleUnregistering a service/title
  programlisting role='php'
 ![CDATA[
 ?php
@@ -82,8 +84,9 @@
 /example
/para
para
-exampletitleRunning as a service/title
-programlisting role='php'
+example
+ titleRunning as a service/title
+ programlisting role='php'
 ![CDATA[
 ?php
 if ($argv[1] == 'run') {
@@ -97,7 +100,7 @@
 }
 ?
 ]]
-/programlisting
+ /programlisting
 /example
/para
   /section


Re: [PHP-DOC] cvs: phpdoc /en/appendices extensions.xml

2005-10-02 Thread Michael Spector
On 17:15, Sun 02 Oct 05, Nuno Lopes wrote:
 michael Sun Oct  2 04:27:25 2005 EDT
 
  Modified files:
/phpdoc/en/appendices extensions.xml
  Log:
  added 'expect' and 'newt' extensions
 
 This file is generated automatically, so you shouldn't add new entries by 
 hand (http://doc.php.net/php/dochowto/scripts.extensions.xml.php.php).

Good to know, thanks!

 And BTW, the newt docs aren't in CVS, so the configure is complaining about 
 the missing ID.
 

Yes, I'll add newt functions once I success generating them with 
xml_proto.php...

-- 
Best regards,

Michael


[PHP-DOC] #34697 [Bgs-Opn]: Undocumented behaviour: class definition before use

2005-10-02 Thread direvus at gmail dot com
 ID:   34697
 User updated by:  direvus at gmail dot com
 Reported By:  direvus at gmail dot com
-Status:   Bogus
+Status:   Open
 Bug Type: Documentation problem
 Operating System: Linux
 PHP Version:  Irrelevant
 New Comment:

No, it doesn't.

It says some of the new features of PHP5.  That's extremely
non-specific.  It could mean that only a couple of the new features
cause the restriction, or it could mean that all of them do.

And I'd like to reiterate my point that, regardless of how clear the
mention is, it is not where it needs to be.  It needs to be in the
manual *and* in the migration guide.

This is a significant (and again, peculiar) property of PHP5 class
syntax.  It's just not right to leave it out of the manual.

Whether you think the existing sentence is sufficient or not, how is
the manual not improved by adding this?


Previous Comments:


[2005-10-02 18:21:56] [EMAIL PROTECTED]

I think it is clear enough.
It says that if you use the new PHP 5 features (interfaces,
inheritance,..) you must declare the class before using it.



[2005-10-01 03:12:54] direvus at gmail dot com

Description:

In the php5 migration guide, we have

In some cases classes must be declared before used. It only happens
only if some of the new features of PHP 5 are used. Otherwise the
behaviour is the old.

I request that this behaviour be documented properly (which features? 
And why?) in the manual chapter on Classes and Objects in PHP5.

I think for most people who are accustomed to PHP definition
conventions, this will come as a surprise.  Functions never need to be
declared before use.  Even methods within a class definition need not
be declared before use.  So why do we have this strange requirement in
the declaration of classes?

This vague mention in the migration guide really isn't sufficient ...
it's a strange and opaque behaviour whether you're migrating code or
not.






-- 
Edit this bug report at http://bugs.php.net/?id=34697edit=1


[PHP-DOC] #34697 [Opn]: Undocumented behaviour: class definition before use

2005-10-02 Thread nlopess
 ID:   34697
 Updated by:   [EMAIL PROTECTED]
 Reported By:  direvus at gmail dot com
 Status:   Open
 Bug Type: Documentation problem
 Operating System: Linux
 PHP Version:  Irrelevant
 New Comment:

I doubt anyone will know exactly what are the features that will make
you have to declare the class prior of its usage. Anyway, declaring the
class before its usage has some performance advantages.

However I couldn't find this info in the language.oop5 chapter, so I'm
leaving this open to add a note to that page.


Previous Comments:


[2005-10-02 22:26:36] direvus at gmail dot com

No, it doesn't.

It says some of the new features of PHP5.  That's extremely
non-specific.  It could mean that only a couple of the new features
cause the restriction, or it could mean that all of them do.

And I'd like to reiterate my point that, regardless of how clear the
mention is, it is not where it needs to be.  It needs to be in the
manual *and* in the migration guide.

This is a significant (and again, peculiar) property of PHP5 class
syntax.  It's just not right to leave it out of the manual.

Whether you think the existing sentence is sufficient or not, how is
the manual not improved by adding this?



[2005-10-02 18:21:56] [EMAIL PROTECTED]

I think it is clear enough.
It says that if you use the new PHP 5 features (interfaces,
inheritance,..) you must declare the class before using it.



[2005-10-01 03:12:54] direvus at gmail dot com

Description:

In the php5 migration guide, we have

In some cases classes must be declared before used. It only happens
only if some of the new features of PHP 5 are used. Otherwise the
behaviour is the old.

I request that this behaviour be documented properly (which features? 
And why?) in the manual chapter on Classes and Objects in PHP5.

I think for most people who are accustomed to PHP definition
conventions, this will come as a surprise.  Functions never need to be
declared before use.  Even methods within a class definition need not
be declared before use.  So why do we have this strange requirement in
the declaration of classes?

This vague mention in the migration guide really isn't sufficient ...
it's a strange and opaque behaviour whether you're migrating code or
not.






-- 
Edit this bug report at http://bugs.php.net/?id=34697edit=1


[PHP-DOC] cvs: phpdoc /en/reference/expect ini.xml

2005-10-02 Thread Jean-S�bastien Goupil
jsgoupilSun Oct  2 17:30:22 2005 EDT

  Modified files:  
/phpdoc/en/reference/expect ini.xml 
  Log:
  WS fix + end tag fix + table fix
  
http://cvs.php.net/diff.php/phpdoc/en/reference/expect/ini.xml?r1=1.1r2=1.2ty=u
Index: phpdoc/en/reference/expect/ini.xml
diff -u phpdoc/en/reference/expect/ini.xml:1.1 
phpdoc/en/reference/expect/ini.xml:1.2
--- phpdoc/en/reference/expect/ini.xml:1.1  Sun Oct  2 02:53:45 2005
+++ phpdoc/en/reference/expect/ini.xml  Sun Oct  2 17:30:21 2005
@@ -1,19 +1,20 @@
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.1 $ --
+!-- $Revision: 1.2 $ --
 section id=expect.configuration
  reftitle.runtime;
  extension.runtime;
  para
   In order to configure expect extension, there are configuration options
   in the link linkend=configuration.fileconfiguration file/link 
php.ini;.
-   table
+  table
titleExpect Configuration Options/title
tgroup cols=4
 thead
  row
-  entryName/entry
-  entryDefault/entry
-  entryChangeable/entry
+  entryName;/entry
+  entryDefault;/entry
+  entryChangeable;/entry
+  entryChangelog/entry
  /row
 /thead
 tbody
@@ -21,81 +22,86 @@
   entryexpect.timeout/entry
   entry10/entry
   entryPHP_INI_ALL/entry
+  entry/entry
  /row
  row
   entryexpect.loguser/entry
   entryOn/entry
   entryPHP_INI_ALL/entry
+  entry/entry
  /row
  row
   entryexpect.logfile/entry
   entry/entry
   entryPHP_INI_ALL/entry
+  entry/entry
  /row
 /tbody
/tgroup
   /table
-   ini.php.constants;
-/para
+  ini.php.constants;
+ /para
  
  ini.descriptions.title;
  
  para
- variablelist
-  varlistentry id=ini.expect.timeout
-   term
-parameterexpect.timeout/parameter
-typeinteger/type
-   /term
-   listitem
-para
-The timeout period for waiting for the data, when using the 
functionexpect_expectl/function function.
-/para
-para
- A value of -1 disables a timeout from occurring.
-/para
-note
+  variablelist
+   varlistentry id=ini.expect.timeout
+term
+ parameterexpect.timeout/parameter
+ typeinteger/type
+/term
+listitem
+ para
+  The timeout period for waiting for the data, when using the
+  functionexpect_expectl/function function.
+ /para
  para
-   A value of 0 causes the functionexpect_expectl/function function 
to return immediately.
+  A value of -1 disables a timeout from occurring.
  /para
-/note
-   /listitem
-  /varlistentry
+ note
+  para
+   A value of 0 causes the functionexpect_expectl/function function
+   to return immediately.
+  /para
+ /note
+/listitem
+   /varlistentry
 
-  varlistentry id=ini.expect.loguser
-   term
-parameterexpect.loguser/parameter
-typeboolean/type
-   /term
-   listitem
-para
- Whether expect should send any output from the spawned process to stdout.
- Since interactive programs typically echo their input, this usually 
suffices
- to show both sides of the conversation.
-/para
-   /listitem
-  /varlistentry
+   varlistentry id=ini.expect.loguser
+term
+ parameterexpect.loguser/parameter
+ typeboolean/type
+/term
+listitem
+ para
+  Whether expect should send any output from the spawned process to stdout.
+  Since interactive programs typically echo their input, this usually 
suffices
+  to show both sides of the conversation.
+ /para
+/listitem
+   /varlistentry
 
-  varlistentry id=ini.expect.logfile
-   term
-parameterexpect.logfile/parameter
-typestring/type
-   /term
-   listitem
-para
- Name of the file, where the output from the spawned process will be
- written. If this file doesn't exist, it will be created.
+   varlistentry id=ini.expect.logfile
+term
+ parameterexpect.logfile/parameter
+ typestring/type
+/term
+listitem
+ para
+  Name of the file, where the output from the spawned process will be
+  written. If this file doesn't exist, it will be created.
  /para
  note
   para
If this configuration is not empty, the output is written regardless of
-   the value of link linkend=ini.expect.loguserexpect.loguser/link
+   the value of link linkend=ini.expect.loguserexpect.loguser/link.
   /para
  /note
-   /listitem
-  /varlistentry
+/listitem
+   /varlistentry
 
- /variablelist
+  /variablelist
  /para
 /section
 
@@ -119,5 +125,3 @@
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 --
-
-


[PHP-DOC] #33269 [Csd-Opn]: link tag displays wrong output when using with type tag

2005-10-02 Thread jsgoupil
 ID:  33269
 Updated by:  [EMAIL PROTECTED]
 Reported By: [EMAIL PROTECTED]
-Status:  Closed
+Status:  Open
 Bug Type:Livedocs problem
 PHP Version: Irrelevant
 New Comment:

/reference/expect/reference.xml
/en/ref.expect.html

link linkend=wrappers.expectliteralexpect:///literal
wrapper/link

Outputs : a class=link
href=/livedocs/en/wrappers.html#wrappers.expectProcess Interaction
Streams/a
Instead of : a class=link
href=/livedocs/en/wrappers.html#wrappers.expectspan
class=literalibm_db2.instance_name/span wrapper/a


Previous Comments:


[2005-06-21 03:44:36] [EMAIL PROTECTED]

This bug has been fixed in CVS.

Snapshots of the sources are packaged every three hours; this change
will be in the next snapshot. You can grab the snapshot at
http://snaps.php.net/.
 
Thank you for the report, and for helping us make PHP better.

I think this is fixed, but if it's not please provide a URL to  page
that demonstrates the problem.



[2005-06-16 02:37:51] [EMAIL PROTECTED]

I'm pretty sure this is the same behavior as #32780.

The link formatter doesn't expect the node to have children, and is
trying to output $node-content (where $node-child[n]-content needs
to be output after a transform).

S




[2005-06-08 01:36:02] [EMAIL PROTECTED]

Description:

When you write something like
link linkend=language.types.ressourceDoc on
typeresource/types/link
It will output directly the Resource title.
So with link linkend=language.types.integerDoc on
typeresource/types/link will output Integer (with the link of
course)

Supposed to output Doc on typeresource/types with the link.






-- 
Edit this bug report at http://bugs.php.net/?id=33269edit=1


[PHP-DOC] #33269 [Opn]: link tag displays wrong output when using with type tag

2005-10-02 Thread jsgoupil
 ID:  33269
 Updated by:  [EMAIL PROTECTED]
 Reported By: [EMAIL PROTECTED]
 Status:  Open
 Bug Type:Livedocs problem
 PHP Version: Irrelevant
 New Comment:

not ibm_db2.instance_name but expect://
(:


Previous Comments:


[2005-10-02 23:39:48] [EMAIL PROTECTED]

/reference/expect/reference.xml
/en/ref.expect.html

link linkend=wrappers.expectliteralexpect:///literal
wrapper/link

Outputs : a class=link
href=/livedocs/en/wrappers.html#wrappers.expectProcess Interaction
Streams/a
Instead of : a class=link
href=/livedocs/en/wrappers.html#wrappers.expectspan
class=literalibm_db2.instance_name/span wrapper/a



[2005-06-21 03:44:36] [EMAIL PROTECTED]

This bug has been fixed in CVS.

Snapshots of the sources are packaged every three hours; this change
will be in the next snapshot. You can grab the snapshot at
http://snaps.php.net/.
 
Thank you for the report, and for helping us make PHP better.

I think this is fixed, but if it's not please provide a URL to  page
that demonstrates the problem.



[2005-06-16 02:37:51] [EMAIL PROTECTED]

I'm pretty sure this is the same behavior as #32780.

The link formatter doesn't expect the node to have children, and is
trying to output $node-content (where $node-child[n]-content needs
to be output after a transform).

S




[2005-06-08 01:36:02] [EMAIL PROTECTED]

Description:

When you write something like
link linkend=language.types.ressourceDoc on
typeresource/types/link
It will output directly the Resource title.
So with link linkend=language.types.integerDoc on
typeresource/types/link will output Integer (with the link of
course)

Supposed to output Doc on typeresource/types with the link.






-- 
Edit this bug report at http://bugs.php.net/?id=33269edit=1


[PHP-DOC] cvs: phpdoc /en/reference/expect/functions expect-expectl.xml

2005-10-02 Thread Jean-S�bastien Goupil
jsgoupilSun Oct  2 17:42:02 2005 EDT

  Modified files:  
/phpdoc/en/reference/expect/functions   expect-expectl.xml 
  Log:
  no dot in refpurpose
  
http://cvs.php.net/diff.php/phpdoc/en/reference/expect/functions/expect-expectl.xml?r1=1.2r2=1.3ty=u
Index: phpdoc/en/reference/expect/functions/expect-expectl.xml
diff -u phpdoc/en/reference/expect/functions/expect-expectl.xml:1.2 
phpdoc/en/reference/expect/functions/expect-expectl.xml:1.3
--- phpdoc/en/reference/expect/functions/expect-expectl.xml:1.2 Sun Oct  2 
04:33:39 2005
+++ phpdoc/en/reference/expect/functions/expect-expectl.xml Sun Oct  2 
17:41:59 2005
@@ -1,10 +1,10 @@
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.2 $ --
+!-- $Revision: 1.3 $ --
 refentry id=function.expect-expectl
  refnamediv
   refnameexpect_expectl/refname
   refpurposeWaits until the output from a process matches one
-  of the patterns, a specified time period has passed, or an EOF is seen.
+  of the patterns, a specified time period has passed, or an EOF is seen
   /refpurpose
  /refnamediv
  refsect1 role=description


[PHP-DOC] #34697 [Opn]: Undocumented behaviour: class definition before use

2005-10-02 Thread direvus at gmail dot com
 ID:   34697
 User updated by:  direvus at gmail dot com
 Reported By:  direvus at gmail dot com
 Status:   Open
 Bug Type: Documentation problem
 Operating System: Linux
 PHP Version:  Irrelevant
 New Comment:

 I doubt anyone will know exactly what are the features that will
make
you have to declare the class prior of its usage.

Well somebody wrote the code that causes this behaviour, so somebody
must know about it.  Unless it's unintended.

 Anyway, declaring the
class before its usage has some performance advantages.

That's good to know, and should also be noted in the manual.

Don't get me wrong, I'm all for declaring classes prior to usage.  I
think it's much better programming style.  But there's a big difference
between it's good style and the language requires it.  A difference
that needs to be well documented.


Previous Comments:


[2005-10-02 22:58:49] [EMAIL PROTECTED]

I doubt anyone will know exactly what are the features that will make
you have to declare the class prior of its usage. Anyway, declaring the
class before its usage has some performance advantages.

However I couldn't find this info in the language.oop5 chapter, so I'm
leaving this open to add a note to that page.



[2005-10-02 22:26:36] direvus at gmail dot com

No, it doesn't.

It says some of the new features of PHP5.  That's extremely
non-specific.  It could mean that only a couple of the new features
cause the restriction, or it could mean that all of them do.

And I'd like to reiterate my point that, regardless of how clear the
mention is, it is not where it needs to be.  It needs to be in the
manual *and* in the migration guide.

This is a significant (and again, peculiar) property of PHP5 class
syntax.  It's just not right to leave it out of the manual.

Whether you think the existing sentence is sufficient or not, how is
the manual not improved by adding this?



[2005-10-02 18:21:56] [EMAIL PROTECTED]

I think it is clear enough.
It says that if you use the new PHP 5 features (interfaces,
inheritance,..) you must declare the class before using it.



[2005-10-01 03:12:54] direvus at gmail dot com

Description:

In the php5 migration guide, we have

In some cases classes must be declared before used. It only happens
only if some of the new features of PHP 5 are used. Otherwise the
behaviour is the old.

I request that this behaviour be documented properly (which features? 
And why?) in the manual chapter on Classes and Objects in PHP5.

I think for most people who are accustomed to PHP definition
conventions, this will come as a surprise.  Functions never need to be
declared before use.  Even methods within a class definition need not
be declared before use.  So why do we have this strange requirement in
the declaration of classes?

This vague mention in the migration guide really isn't sufficient ...
it's a strange and opaque behaviour whether you're migrating code or
not.






-- 
Edit this bug report at http://bugs.php.net/?id=34697edit=1