[PHP-DOC] Re: Wrong french translation in Returning references

2004-07-31 Thread Mehdi Achour
Hi Bernard,
Thank you for your fix, I just applied it to the french translation.
Would you mind sending your next corrections to [EMAIL PROTECTED] ?
Thank you !
Mehdi Achour
Bmr wrote:
Hi,
I couldn't understand the example in 
http://www.php.net/manual/fr/language.references.return.php reading the 
french translation. Unless I'm mistaken, that's the object which is 
returned by the function, not the property (because of different 
genders, the french may distinguish between both). IMO this translation 
should be :

"Dans cet exemple, on affecte une valeur à la propriété de l'objet 
retourné par la fonction find_var, et non à sa copie, comme ce serait le 
cas si on n'avait pas utilisé la syntaxe de référence."

Friendly
Bernard Martin-Rabaud


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

2004-07-31 Thread Nuno Lopes
>  If your webserver is running PHP in CGI mode, you should note that
the
> -CGI version has changed its name from php.exe to php-cgi.exe.
> -In Apache you should do something like this:
> -
> +CGI version has changed its name :
> +(php.exe becomes
php-cgi.exe.
> +In Apache, you should do something like this:

can you please correct this?

you have : and a ( which isn't closed. You can keep the old wording,
introducing just the  tags, IHMO.

Nuno


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

2004-07-31 Thread Damien Seguy
damsSat Jul 31 14:30:07 2004 EDT

  Modified files:  
/phpdoc/en/appendices   migration5.xml 
  Log:
  fixing filename tags
  
http://cvs.php.net/diff.php/phpdoc/en/appendices/migration5.xml?r1=1.29&r2=1.30&ty=u
Index: phpdoc/en/appendices/migration5.xml
diff -u phpdoc/en/appendices/migration5.xml:1.29 
phpdoc/en/appendices/migration5.xml:1.30
--- phpdoc/en/appendices/migration5.xml:1.29Sat Jul 31 01:14:55 2004
+++ phpdoc/en/appendices/migration5.xml Sat Jul 31 14:30:07 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Migrating from PHP 4 to PHP 5
 
@@ -192,9 +192,9 @@
CLI and CGI

 In PHP 5 there were some changes in CLI and CGI filenames. In PHP 5, the
-CGI version was renamed to php-cgi.exe (previously
-php.exe) and the CLI version now sits in the main
-directory (previously cli/php.exe).
+CGI version was renamed to php-cgi.exe (previously
+php.exe) and the CLI version now sits in the main
+directory (previously cli/php.exe).


 In PHP 5 it was also introduced a new mode:
@@ -227,7 +227,8 @@

 Migrate the Apache configuration is extremely easy. See the example below
 to check the change you need to do:
-
+
+ Migrating Apache configuration files for PHP 5
  
 
  
-
+


 If your webserver is running PHP in CGI mode, you should note that the
-CGI version has changed its name from php.exe to php-cgi.exe.
-In Apache you should do something like this:
-
+CGI version has changed its name : 
+(php.exe becomes php-cgi.exe. 
+In Apache, you should do something like this:
+
+ Migrating Apache configuration files for PHP 5, CGI mode
  
 
  
-
+


 In other webservers you need to change either the CGI or the ISAPI module


Re: [PHP-DOC] PECL Doc questions

2004-07-31 Thread Nuno Lopes
> I just run Hartmuts split script (/scripts/reference-split.php) on PECL
> extension in peardoc.
> As Hartmuts script is a bit dated, the structure of the files does not fit
in
> the current phpdoc style (configure.xml, constants.xml etc.) and the id's
and
> filenames are with leading pecl., which probably is not what we want?

nop. the IDs should be changed from pecl.xxx to ref.xxx
the functions IDs should also be changed to function.xxx (and the files
shouldn't have pecl prepended)


> Beside the points mentioned above entities/urls need some polish.
> apd.xml, paradox.xml and ps.xml are currently worked on, all other docs
have
> last change times from 2003 and only few files have been translated.

The files need a big polish :) (including WS fixes).
Later we should also agree on the entities (I haven't read the Philip's
email yet) to include in these files.


> I can take care of the move and polish the files for phpdoc after we made
a
> decision how to handle the move.

Thanks! I can also help you, but commit the files first :)


Nuno


Re: [PHP-DOC] PECL Doc questions

2004-07-31 Thread Friedhelm Betz
On Friday 30 July 2004 23:14, Gabor Hojtsy wrote:
[...]
>
> > Doc moves:
> > When (or if) will the Hartmut split script be run on all PECL
> > extensions currently in peardoc?
> >   Ref: http://marc.theaimsgroup.com/?l=phpdoc&m=107374866303330
>
> Anytime someone sits down and does it :) It is a TODO item, but noone
> grabbed it yet.
>

I just run Hartmuts split script (/scripts/reference-split.php) on PECL 
extension in peardoc. 
As Hartmuts script is a bit dated, the structure of the files does not fit in 
the current phpdoc style (configure.xml, constants.xml etc.) and the id's and 
filenames are with leading pecl., which probably is not what we want?

Beside the points mentioned above entities/urls need some polish.
apd.xml, paradox.xml and ps.xml are currently worked on, all other docs have 
last change times from 2003 and only few files have been translated.

I can take care of the move and polish the files for phpdoc after we made a 
decision how to handle the move.

Raw output sources from the split:
http://www.holliwell.de/phpdoc/

Friedhelm

-- 
http://www.jungle-world.com/


Re: [PHP-DOC] translations

2004-07-31 Thread Friedhelm Betz
Hi,

> Hi,
>
> My name's Gosia, I'm from Poland and I'd like to help translate the php
> manual to Polish.

You can contact the polish translation team by mail: [EMAIL PROTECTED]

Regards 
Friedhelm

-- 
http://www.jungle-world.com/


[PHP-DOC] translations

2004-07-31 Thread Gosia



Hi,
 
My name's Gosia, I'm from Poland and I'd like to 
help translate the php manual to Polish.


[PHP-DOC] cvs: phpdoc /en/reference/stream constants.xml /en/reference/stream/functions stream-socket-accept.xml stream-socket-recvfrom.xml

2004-07-31 Thread Nuno Lopes
nlopess Sat Jul 31 10:41:54 2004 EDT

  Modified files:  
/phpdoc/en/reference/stream constants.xml 
/phpdoc/en/reference/stream/functions   stream-socket-accept.xml 
stream-socket-recvfrom.xml 
  Log:
  several fixes for UDP
  thanks Wez
  
http://cvs.php.net/diff.php/phpdoc/en/reference/stream/constants.xml?r1=1.11&r2=1.12&ty=u
Index: phpdoc/en/reference/stream/constants.xml
diff -u phpdoc/en/reference/stream/constants.xml:1.11 
phpdoc/en/reference/stream/constants.xml:1.12
--- phpdoc/en/reference/stream/constants.xml:1.11   Sat Jul 31 07:48:38 2004
+++ phpdoc/en/reference/stream/constants.xmlSat Jul 31 10:41:54 2004
@@ -1,5 +1,5 @@
 
-
+
 
  &reftitle.constants;
  &extension.constants;
@@ -95,7 +95,9 @@
   STREAM_SERVER_LISTEN *
   Tells a stream created with stream_socket_server
and bound using the STREAM_SERVER_BIND flag to start
-   listening on the socket. TCP Server sockets should always include this flag.
+   listening on the socket. Connection-orientated transports (such as TCP)
+   must use this flag, otherwise the server socket will not be enabled.
+   Using this flag for connect-less transports (such as UDP) is an error.
   
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/stream/functions/stream-socket-accept.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc/en/reference/stream/functions/stream-socket-accept.xml
diff -u phpdoc/en/reference/stream/functions/stream-socket-accept.xml:1.3 
phpdoc/en/reference/stream/functions/stream-socket-accept.xml:1.4
--- phpdoc/en/reference/stream/functions/stream-socket-accept.xml:1.3   Sat Jul 31 
07:48:38 2004
+++ phpdoc/en/reference/stream/functions/stream-socket-accept.xml   Sat Jul 31 
10:41:54 2004
@@ -1,5 +1,5 @@
 
-
+
   

 stream_socket_accept
@@ -31,13 +31,13 @@
 
  If the call fails, it will return &false;.
 
-
+
  
-  This function doens't work with UDP server sockets. Use
+  Using this function with UDP server sockets is an error. You should use
   stream_socket_recvfrom and
   stream_socket_sendto instead.
  
-
+   
 
  See also stream_socket_server, 
  stream_socket_get_name,
http://cvs.php.net/diff.php/phpdoc/en/reference/stream/functions/stream-socket-recvfrom.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc/en/reference/stream/functions/stream-socket-recvfrom.xml
diff -u phpdoc/en/reference/stream/functions/stream-socket-recvfrom.xml:1.3 
phpdoc/en/reference/stream/functions/stream-socket-recvfrom.xml:1.4
--- phpdoc/en/reference/stream/functions/stream-socket-recvfrom.xml:1.3 Mon Mar 29 
18:21:04 2004
+++ phpdoc/en/reference/stream/functions/stream-socket-recvfrom.xml Sat Jul 31 
10:41:54 2004
@@ -1,5 +1,5 @@
 
-
+
   

 stream_socket_recvfrom
@@ -73,6 +73,13 @@
 ]]>
  
 
+
+ 
+  If a message received is longer than the length
+  parameter, excess bytes may be discarded depending on the type of socket
+  the message is received from (such as UDP).
+ 
+
 
  See also 
  stream_socket_sendto,


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

2004-07-31 Thread Gabor Hojtsy
I simply didn't think my contributions warranted credit as an author. 
As of late I haven't been contributing because of lack of time (and
interest).  I'm uncertain whether or not I'll be contributing in the
near future.

I have no specific complaints of being in the credits, I simply asked
Dave if he could remove me.  Feel free to revert the changes or add it
elsewhere.
If you feel you don't belong there, then well, so be it. (Also cc-ed the 
 mailing list to get people informed, and get changes documented 
publically).

Goba


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

2004-07-31 Thread Gabor Hojtsy
He was cc-ed with my question.
Goba
Hm, why?

Goba
I'm not sure exactly, we got speaking and I mentioned that he was
listed on the contributor page and the bookinfo page, and he asked
that he be removed.
Maybe you can email him directly? irchtml at php dot net probably
still works.
Dave

daveSat Jul 31 08:44:00 2004 EDT
 Modified files:  
   /phpdoc/en	contributors.xml 
 Log:
 - At the request of Kenneth.
 
 
http://cvs.php.net/diff.php/phpdoc/en/contributors.xml?r1=1.8&r2=1.9&ty=u
Index: phpdoc/en/contributors.xml
diff -u phpdoc/en/contributors.xml:1.8 phpdoc/en/contributors.xml:1.9
--- phpdoc/en/contributors.xml:1.8	Thu Jul 29 09:34:59 2004
+++ phpdoc/en/contributors.xml	Sat Jul 31 08:44:00 2004
@@ -1,5 +1,5 @@

-
+

 
   Aidan Lister,
   Nuno Lopes,  
-   Kenneth Schwartz&listendand; 
   Tom Sommer.  
  
 




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

2004-07-31 Thread Dave
On Saturday, July 31, 2004, 11:24:26 PM, Gabor wrote:

> Hm, why?

> Goba

I'm not sure exactly, we got speaking and I mentioned that he was
listed on the contributor page and the bookinfo page, and he asked
that he be removed.

Maybe you can email him directly? irchtml at php dot net probably
still works.

Dave

>> dave Sat Jul 31 08:44:00 2004 EDT
>> 
>>   Modified files:  
>> /phpdoc/en   contributors.xml 
>>   Log:
>>   - At the request of Kenneth.
>>   
>>   
>> http://cvs.php.net/diff.php/phpdoc/en/contributors.xml?r1=1.8&r2=1.9&ty=u
>> Index: phpdoc/en/contributors.xml
>> diff -u phpdoc/en/contributors.xml:1.8 phpdoc/en/contributors.xml:1.9
>> --- phpdoc/en/contributors.xml:1.8   Thu Jul 29 09:34:59 2004
>> +++ phpdoc/en/contributors.xml   Sat Jul 31 08:44:00 2004
>> @@ -1,5 +1,5 @@
>>  
>> -
>> +
>>  
>>   
>> Aidan Lister,
>> Nuno Lopes,  
>> -   Kenneth Schwartz&listendand; 
>> Tom Sommer.  
>>
>>   
>> 


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

2004-07-31 Thread Gabor Hojtsy
Hm, why?
Goba
daveSat Jul 31 08:44:00 2004 EDT
  Modified files:  
/phpdoc/en	contributors.xml 
  Log:
  - At the request of Kenneth.
  
  
http://cvs.php.net/diff.php/phpdoc/en/contributors.xml?r1=1.8&r2=1.9&ty=u
Index: phpdoc/en/contributors.xml
diff -u phpdoc/en/contributors.xml:1.8 phpdoc/en/contributors.xml:1.9
--- phpdoc/en/contributors.xml:1.8	Thu Jul 29 09:34:59 2004
+++ phpdoc/en/contributors.xml	Sat Jul 31 08:44:00 2004
@@ -1,5 +1,5 @@
 
-
+
 
  
Aidan Lister,
Nuno Lopes,  
-   Kenneth Schwartz&listendand; 
Tom Sommer.  
   
  



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

2004-07-31 Thread Dave
daveSat Jul 31 08:55:22 2004 EDT

  Modified files:  
/phpdoc/en  contributors.xml 
  Log:
  - Add listendand back. Oops.
  
  
http://cvs.php.net/diff.php/phpdoc/en/contributors.xml?r1=1.9&r2=1.10&ty=u
Index: phpdoc/en/contributors.xml
diff -u phpdoc/en/contributors.xml:1.9 phpdoc/en/contributors.xml:1.10
--- phpdoc/en/contributors.xml:1.9  Sat Jul 31 08:44:00 2004
+++ phpdoc/en/contributors.xml  Sat Jul 31 08:55:22 2004
@@ -1,5 +1,5 @@
 
-
+
 
  
Vincent Gevers,  
Aidan Lister,
-   Nuno Lopes,  
+   Nuno Lopes&listendand;   
Tom Sommer.  
   
  


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

2004-07-31 Thread Dave
daveSat Jul 31 08:53:07 2004 EDT

  Modified files:  
/phpdoc/en  bookinfo.xml 
  Log:
  - At the request of Kenneth.
  
  
http://cvs.php.net/diff.php/phpdoc/en/bookinfo.xml?r1=1.41&r2=1.42&ty=u
Index: phpdoc/en/bookinfo.xml
diff -u phpdoc/en/bookinfo.xml:1.41 phpdoc/en/bookinfo.xml:1.42
--- phpdoc/en/bookinfo.xml:1.41 Wed Jul 28 17:22:01 2004
+++ phpdoc/en/bookinfo.xml  Sat Jul 31 08:53:07 2004
@@ -1,5 +1,5 @@
 
-
+
 
  
   &PHPManual;
@@ -27,10 +27,6 @@


 GeorgRichter 
-   
-
-   
-KennethSchwartz 

 



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

2004-07-31 Thread Dave
daveSat Jul 31 08:44:00 2004 EDT

  Modified files:  
/phpdoc/en  contributors.xml 
  Log:
  - At the request of Kenneth.
  
  
http://cvs.php.net/diff.php/phpdoc/en/contributors.xml?r1=1.8&r2=1.9&ty=u
Index: phpdoc/en/contributors.xml
diff -u phpdoc/en/contributors.xml:1.8 phpdoc/en/contributors.xml:1.9
--- phpdoc/en/contributors.xml:1.8  Thu Jul 29 09:34:59 2004
+++ phpdoc/en/contributors.xml  Sat Jul 31 08:44:00 2004
@@ -1,5 +1,5 @@
 
-
+
 
  
Aidan Lister,
Nuno Lopes,  
-   Kenneth Schwartz&listendand; 
Tom Sommer.  
   
  


Re: [PHP-DOC] cvs: phpdoc /en/reference/stream constants.xml /en/reference/stream/functions stream-socket-accept.xml stream-socket-server.xml

2004-07-31 Thread Wez Furlong
> > PHP 5.1 will include a new function "stream_socket_listen" that will
> > allow you manually listen().  The rationale for that is that you might
> > want to alter some socket settings before actually accepting
> > connections.  Currently, there aren't any of these to configure, so it
> > is low priority.
> 
> Was this already added?

not yet.
 
> > The UDP example reads only a single byte; check the specs for the
> > daytime protocol to see how much it should read; if it isn't reading
> > enough, that script might break.
> 
> Quote (http://www.faqs.org/rfcs/rfc867.html):
> "UDP Based Daytime Service
>Another daytime service service is defined as a datagram based
>application on UDP.  A server listens for UDP datagrams on UDP port
>13.  When a datagram is received, an answering datagram is sent
>containing the current date and time as a ASCII character string (the
>data in the received datagram is ignored)."
> 
> Uhm, I think 1 byte is enough?

Then is is worth noting the following in the recvfrom docs (excerpt
from recvfrom(2)):

If a message is too long to fit in the supplied buffer, excess bytes
may be discarded depending on the type of socket the message is
received from.

This applies to datagram orientated sockets.

--Wez.


Re: [PHP-DOC] Re: language-snippets.ent not updating in build?

2004-07-31 Thread Nuno Lopes
I hope you had nice vacations :)

This isn't a bug. Philip was just confused with the two separate install
dirs.

Nuno


> On Wed, 21 Jul 2004, Philip Olson wrote:
>
> > Notice the change doesn't show up in the  on that page, anyone
> > have an idea why?
>
> I'l have a look this week, I was on holiday.
>
> Derick


Re: [PHP-DOC] Re: language-snippets.ent not updating in build?

2004-07-31 Thread Gabor Hojtsy
Notice the change doesn't show up in the  on that page, anyone
have an idea why?
I'l have a look this week, I was on holiday.
No worries, we already found the problem (Philip was confused by the two 
install sections in existance in the manual source).

Goba


[PHP-DOC] Re: language-snippets.ent not updating in build?

2004-07-31 Thread Derick Rethans
On Wed, 21 Jul 2004, Philip Olson wrote:

> Notice the change doesn't show up in the  on that page, anyone
> have an idea why?

I'l have a look this week, I was on holiday.

Derick


Re: [PHP-DOC] cvs: phpdoc /en/reference/stream constants.xml /en/reference/stream/functions stream-socket-accept.xml stream-socket-server.xml

2004-07-31 Thread Nuno Lopes
> Hey Nuno,
>
> A couple of comments:
>
> The LISTEN flag is used to actually "switch-on" a
> connection-orientated transport (eg: TCP) so that it can accept
> connections.
>
> So that sentence should read something like:
>
> "Connection-orientated transports (such as TCP) must use this flag,
> otherwise the server socket will not be enabled.  Using this flag for
> connect-less transports (such as UDP) is an error."

OK, I'll change that.


> PHP 5.1 will include a new function "stream_socket_listen" that will
> allow you manually listen().  The rationale for that is that you might
> want to alter some socket settings before actually accepting
> connections.  Currently, there aren't any of these to configure, so it
> is low priority.

Was this already added?


> Rather than saying "this function doesn't work with UDP sockets", you
> should say "it is an error to use this function with UDP sockets",
> because the function itself isn't broken or deficient; using it with
> UDP sockets is an error in your code.

I'll change this too. And maybe turn  into .


> The UDP example reads only a single byte; check the specs for the
> daytime protocol to see how much it should read; if it isn't reading
> enough, that script might break.

Quote (http://www.faqs.org/rfcs/rfc867.html):
"UDP Based Daytime Service
   Another daytime service service is defined as a datagram based
   application on UDP.  A server listens for UDP datagrams on UDP port
   13.  When a datagram is received, an answering datagram is sent
   containing the current date and time as a ASCII character string (the
   data in the received datagram is ignored)."

Uhm, I think 1 byte is enough?


Thanks for your comments!

Nuno


> On Sat, 31 Jul 2004 11:48:38 -, Nuno Lopes <[EMAIL PROTECTED]> wrote:
> > nlopess Sat Jul 31 07:48:38 2004 EDT
> >
> >   Modified files:
> > /phpdoc/en/reference/stream constants.xml
> > /phpdoc/en/reference/stream/functions   stream-socket-accept.xml
> > stream-socket-server.xml
> >   Log:
> >   fix #27211: clarify how to use UDP server sockets
> >   #please review this
> >
> >
http://cvs.php.net/diff.php/phpdoc/en/reference/stream/constants.xml?r1=1.10&r2=1.11&ty=u
> > Index: phpdoc/en/reference/stream/constants.xml
> > diff -u phpdoc/en/reference/stream/constants.xml:1.10
phpdoc/en/reference/stream/constants.xml:1.11
> > --- phpdoc/en/reference/stream/constants.xml:1.10   Fri May 21
11:20:48 2004
> > +++ phpdoc/en/reference/stream/constants.xmlSat Jul 31 07:48:38 2004
> > @@ -1,5 +1,5 @@
> >  
> > -
> > +
> >  
> >   &reftitle.constants;
> >   &extension.constants;
> > @@ -95,7 +95,7 @@
> >STREAM_SERVER_LISTEN *
> >Tells a stream created with
stream_socket_server
> > and bound using the STREAM_SERVER_BIND flag
to start
> > -   listening on the socket.  Server sockets should always include
this flag.
> > +   listening on the socket. TCP Server sockets should always
include this flag.
> >
> >   
> >   
> >
http://cvs.php.net/diff.php/phpdoc/en/reference/stream/functions/stream-socket-accept.xml?r1=1.2&r2=1.3&ty=u
> > Index: phpdoc/en/reference/stream/functions/stream-socket-accept.xml
> > diff -u
phpdoc/en/reference/stream/functions/stream-socket-accept.xml:1.2
phpdoc/en/reference/stream/functions/stream-socket-accept.xml:1.3
> > --- phpdoc/en/reference/stream/functions/stream-socket-accept.xml:1.2
Thu Apr  1 01:31:14 2004
> > +++ phpdoc/en/reference/stream/functions/stream-socket-accept.xml
Sat Jul 31 07:48:38 2004
> > @@ -1,5 +1,5 @@
> >  
> > -
> > +
> >
> > 
> >  stream_socket_accept
> > @@ -31,6 +31,13 @@
> >  
> >   If the call fails, it will return &false;.
> >  
> > +
> > + 
> > +  This function doens't work with UDP server sockets. Use
> > +  stream_socket_recvfrom and
> > +  stream_socket_sendto instead.
> > + 
> > +
> >  
> >   See also stream_socket_server,
> >   stream_socket_get_name,
> >
http://cvs.php.net/diff.php/phpdoc/en/reference/stream/functions/stream-socket-server.xml?r1=1.15&r2=1.16&ty=u
> > Index: phpdoc/en/reference/stream/functions/stream-socket-server.xml
> > diff -u
phpdoc/en/reference/stream/functions/stream-socket-server.xml:1.15
phpdoc/en/reference/stream/functions/stream-socket-server.xml:1.16
> > --- phpdoc/en/reference/stream/functions/stream-socket-server.xml:1.15
Wed Jun 16 09:01:22 2004
> > +++ phpdoc/en/reference/stream/functions/stream-socket-server.xml
Sat Jul 31 07:48:38 2004
> > @@ -1,5 +1,5 @@
> >  
> > -
> > +
> >
> > 
> >  stream_socket_server
> > @@ -32,6 +32,12 @@
> >   combination of socket creation flags.  The default value of flags
is
> >   STREAM_SERVER_BIND |
STREAM_SERVER_LISTEN.
> >  
> > +
> > + 
> > +  For UDP sockets, you must use
STREAM_SERVER_BIND as
> > +  the flags parameter.
> > + 
> > +
> >  
> >   This function only cr

Re: [PHP-DOC] cvs: phpdoc /en/reference/stream constants.xml /en/reference/stream/functions stream-socket-accept.xml stream-socket-server.xml

2004-07-31 Thread Wez Furlong
Hey Nuno,

A couple of comments:

The LISTEN flag is used to actually "switch-on" a
connection-orientated transport (eg: TCP) so that it can accept
connections.

So that sentence should read something like:

"Connection-orientated transports (such as TCP) must use this flag,
otherwise the server socket will not be enabled.  Using this flag for
connect-less transports (such as UDP) is an error."

PHP 5.1 will include a new function "stream_socket_listen" that will
allow you manually listen().  The rationale for that is that you might
want to alter some socket settings before actually accepting
connections.  Currently, there aren't any of these to configure, so it
is low priority.

Rather than saying "this function doesn't work with UDP sockets", you
should say "it is an error to use this function with UDP sockets",
because the function itself isn't broken or deficient; using it with
UDP sockets is an error in your code.

The UDP example reads only a single byte; check the specs for the
daytime protocol to see how much it should read; if it isn't reading
enough, that script might break.

--Wez.

On Sat, 31 Jul 2004 11:48:38 -, Nuno Lopes <[EMAIL PROTECTED]> wrote:
> nlopess Sat Jul 31 07:48:38 2004 EDT
> 
>   Modified files:
> /phpdoc/en/reference/stream constants.xml
> /phpdoc/en/reference/stream/functions   stream-socket-accept.xml
> stream-socket-server.xml
>   Log:
>   fix #27211: clarify how to use UDP server sockets
>   #please review this
> 
> http://cvs.php.net/diff.php/phpdoc/en/reference/stream/constants.xml?r1=1.10&r2=1.11&ty=u
> Index: phpdoc/en/reference/stream/constants.xml
> diff -u phpdoc/en/reference/stream/constants.xml:1.10 
> phpdoc/en/reference/stream/constants.xml:1.11
> --- phpdoc/en/reference/stream/constants.xml:1.10   Fri May 21 11:20:48 2004
> +++ phpdoc/en/reference/stream/constants.xmlSat Jul 31 07:48:38 2004
> @@ -1,5 +1,5 @@
>  
> -
> +
>  
>   &reftitle.constants;
>   &extension.constants;
> @@ -95,7 +95,7 @@
>STREAM_SERVER_LISTEN *
>Tells a stream created with stream_socket_server
> and bound using the STREAM_SERVER_BIND flag to start
> -   listening on the socket.  Server sockets should always include this flag.
> +   listening on the socket. TCP Server sockets should always include this flag.
>
>   
>   
> http://cvs.php.net/diff.php/phpdoc/en/reference/stream/functions/stream-socket-accept.xml?r1=1.2&r2=1.3&ty=u
> Index: phpdoc/en/reference/stream/functions/stream-socket-accept.xml
> diff -u phpdoc/en/reference/stream/functions/stream-socket-accept.xml:1.2 
> phpdoc/en/reference/stream/functions/stream-socket-accept.xml:1.3
> --- phpdoc/en/reference/stream/functions/stream-socket-accept.xml:1.2   Thu Apr  1 
> 01:31:14 2004
> +++ phpdoc/en/reference/stream/functions/stream-socket-accept.xml   Sat Jul 31 
> 07:48:38 2004
> @@ -1,5 +1,5 @@
>  
> -
> +
>
> 
>  stream_socket_accept
> @@ -31,6 +31,13 @@
>  
>   If the call fails, it will return &false;.
>  
> +
> + 
> +  This function doens't work with UDP server sockets. Use
> +  stream_socket_recvfrom and
> +  stream_socket_sendto instead.
> + 
> +
>  
>   See also stream_socket_server,
>   stream_socket_get_name,
> http://cvs.php.net/diff.php/phpdoc/en/reference/stream/functions/stream-socket-server.xml?r1=1.15&r2=1.16&ty=u
> Index: phpdoc/en/reference/stream/functions/stream-socket-server.xml
> diff -u phpdoc/en/reference/stream/functions/stream-socket-server.xml:1.15 
> phpdoc/en/reference/stream/functions/stream-socket-server.xml:1.16
> --- phpdoc/en/reference/stream/functions/stream-socket-server.xml:1.15  Wed Jun 16 
> 09:01:22 2004
> +++ phpdoc/en/reference/stream/functions/stream-socket-server.xml   Sat Jul 31 
> 07:48:38 2004
> @@ -1,5 +1,5 @@
>  
> -
> +
>
> 
>  stream_socket_server
> @@ -32,6 +32,12 @@
>   combination of socket creation flags.  The default value of flags is
>   STREAM_SERVER_BIND | 
> STREAM_SERVER_LISTEN.
>  
> +
> + 
> +  For UDP sockets, you must use STREAM_SERVER_BIND as
> +  the flags parameter.
> + 
> +
>  
>   This function only creates a socket, to begin accepting connections
>   use stream_socket_accept.
> @@ -59,7 +65,7 @@
>  
>  
>   
> -  stream_socket_server Example
> +  Using TCP server sockets
>
>  
>
>   
>


[PHP-DOC] #27211 [Asn->Csd]: stream_socket_accept() returns Invalid argument

2004-07-31 Thread nlopess
 ID:   27211
 Updated by:   [EMAIL PROTECTED]
 Reported By:  glox at glox dot be
-Status:   Assigned
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: *
 PHP Version:  5CVS-2004-02-12
 Assigned To:  nlopess
 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.




Previous Comments:


[2004-06-03 19:53:37] [EMAIL PROTECTED]

I had no time to fix this yet, but you should use something like:

$srv = stream_socket_server("udp://127.0.0.1:13");
do {
   $pkt = stream_socket_recvfrom($srv, 1, 0, $peer);
   stream_socket_sendto($srv, date("D M j H:i:s Y\r\n"), 0, $peer);
} while ($pkt !== false);



[2004-06-02 22:28:50] flugelaar at pandora dot be

Is there news about this bug?



[2004-04-30 13:53:39] i_kobayashi at rnk dot co dot jp

In communication by udp, it is not accept() but recvfrom(). However,
since there is no means to acquire an address and a port from
stream_socket_recvfrom(), a reply cannot be returned. Are there any of
other means?



[2004-03-15 10:27:04] [EMAIL PROTECTED]

Shame on me, but I've lost the e-mails I've exchanged with Wez (my ISP
fault).
I don't remeber very well how to reproduce the crash :(

Wez sent me some examples to fix the ones that are currently in the
docs, but I've lost them... :-(



[2004-03-15 10:20:55] [EMAIL PROTECTED]

Assigning to Nuno. (Please report the possible crash in different
report if you haven't done it already)




The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
http://bugs.php.net/27211

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


[PHP-DOC] cvs: phpdoc /en/reference/stream constants.xml /en/reference/stream/functions stream-socket-accept.xml stream-socket-server.xml

2004-07-31 Thread Nuno Lopes
nlopess Sat Jul 31 07:48:38 2004 EDT

  Modified files:  
/phpdoc/en/reference/stream constants.xml 
/phpdoc/en/reference/stream/functions   stream-socket-accept.xml 
stream-socket-server.xml 
  Log:
  fix #27211: clarify how to use UDP server sockets
  #please review this
  
http://cvs.php.net/diff.php/phpdoc/en/reference/stream/constants.xml?r1=1.10&r2=1.11&ty=u
Index: phpdoc/en/reference/stream/constants.xml
diff -u phpdoc/en/reference/stream/constants.xml:1.10 
phpdoc/en/reference/stream/constants.xml:1.11
--- phpdoc/en/reference/stream/constants.xml:1.10   Fri May 21 11:20:48 2004
+++ phpdoc/en/reference/stream/constants.xmlSat Jul 31 07:48:38 2004
@@ -1,5 +1,5 @@
 
-
+
 
  &reftitle.constants;
  &extension.constants;
@@ -95,7 +95,7 @@
   STREAM_SERVER_LISTEN *
   Tells a stream created with stream_socket_server
and bound using the STREAM_SERVER_BIND flag to start
-   listening on the socket.  Server sockets should always include this flag.
+   listening on the socket. TCP Server sockets should always include this flag.
   
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/stream/functions/stream-socket-accept.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc/en/reference/stream/functions/stream-socket-accept.xml
diff -u phpdoc/en/reference/stream/functions/stream-socket-accept.xml:1.2 
phpdoc/en/reference/stream/functions/stream-socket-accept.xml:1.3
--- phpdoc/en/reference/stream/functions/stream-socket-accept.xml:1.2   Thu Apr  1 
01:31:14 2004
+++ phpdoc/en/reference/stream/functions/stream-socket-accept.xml   Sat Jul 31 
07:48:38 2004
@@ -1,5 +1,5 @@
 
-
+
   

 stream_socket_accept
@@ -31,6 +31,13 @@
 
  If the call fails, it will return &false;.
 
+
+ 
+  This function doens't work with UDP server sockets. Use
+  stream_socket_recvfrom and
+  stream_socket_sendto instead.
+ 
+
 
  See also stream_socket_server, 
  stream_socket_get_name,
http://cvs.php.net/diff.php/phpdoc/en/reference/stream/functions/stream-socket-server.xml?r1=1.15&r2=1.16&ty=u
Index: phpdoc/en/reference/stream/functions/stream-socket-server.xml
diff -u phpdoc/en/reference/stream/functions/stream-socket-server.xml:1.15 
phpdoc/en/reference/stream/functions/stream-socket-server.xml:1.16
--- phpdoc/en/reference/stream/functions/stream-socket-server.xml:1.15  Wed Jun 16 
09:01:22 2004
+++ phpdoc/en/reference/stream/functions/stream-socket-server.xml   Sat Jul 31 
07:48:38 2004
@@ -1,5 +1,5 @@
 
-
+
   

 stream_socket_server
@@ -32,6 +32,12 @@
  combination of socket creation flags.  The default value of flags is
  STREAM_SERVER_BIND | 
STREAM_SERVER_LISTEN.
 
+
+ 
+  For UDP sockets, you must use STREAM_SERVER_BIND as
+  the flags parameter.
+ 
+
 
  This function only creates a socket, to begin accepting connections
  use stream_socket_accept.
@@ -59,7 +65,7 @@
 
 
  
-  stream_socket_server Example
+  Using TCP server sockets
   
 
   
  


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

2004-07-31 Thread Nuno Lopes
nlopess Sat Jul 31 06:59:31 2004 EDT

  Modified files:  
/phpdoc/en/appendices   tokens.xml 
  Log:
  add 'PHP 5 only' note to PHPDoc
  thanks Goba
  
http://cvs.php.net/diff.php/phpdoc/en/appendices/tokens.xml?r1=1.13&r2=1.14&ty=u
Index: phpdoc/en/appendices/tokens.xml
diff -u phpdoc/en/appendices/tokens.xml:1.13 phpdoc/en/appendices/tokens.xml:1.14
--- phpdoc/en/appendices/tokens.xml:1.13Sat Jul 31 06:02:17 2004
+++ phpdoc/en/appendices/tokens.xml Sat Jul 31 06:59:30 2004
@@ -1,5 +1,5 @@
 
-
+
 
 
  List of Parser Tokens
@@ -153,7 +153,7 @@
 
  T_DOC_COMMENT
  /** */
- PHPDoc style 
comments
+ PHPDoc style 
comments (PHP 5 only)
 
 
  T_DO



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

2004-07-31 Thread Nuno Lopes
> >  
> > + T_DOC_COMMENT
> > + /** */
> > + PHPDoc style
comments
>
> (in PHP 5) seems to be missing from here
>
> Goba


I've forgot that.. Sorry!

I'll fix that in a minute

Nuno



Re: [PHP-DOC] http://www.php.net/manual/en/ref.pfpro.php

2004-07-31 Thread Nuno Lopes
Hello Justin,

The notes system is currently down.

I've added your note to the manual. It should be on-line in a week or so.

Thanks,
Nuno


- Original Message - 
From: "Meyer, Justin" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Friday, July 30, 2004 5:33 PM
Subject: [PHP-DOC] http://www.php.net/manual/en/ref.pfpro.php


> Hi Guys,
>
> The information/documentation at the above URL is missing a small but
> critical bit of information that may cause a lot of folks to be unable to
> use this extension. I've been attempting to add a note there, and an
> internal error is reported each time.
>
> If I cannot add the note at this time, would it be possible for you to
> either revise the docs, or add the note for me? Below is what I had
written:
>
> "Hi All,
>
> One thing the updated config notes don't cover is that you almost
certainly
> need to configure/build this extension as a shared extension -- Payflow
Pro
> is statically linked to an older version of OpenSSL, and if you try to
> compile this extension statically into PHP, and then use it with ModSSL or
> the OpenSSL extension, you'll run into segfaults and other interesting
> problems. So:
>
> ./configure --with-pfpro=shared,/usr/local
>
> I repeat: If you do not build this extension as a shared extension, you
will
> almost certainly have problems!
>
> Once PHP is built and installed, you'll then need to modify your php.ini
in
> two places:
>
> One, set extension_dir to the directory in which you find 'pfpro.so', so
> that PHP knows where to find the extension.
>
> Two, add a line to php.ini that reads 'extension=pfpro.so' (minus the
> quotes!), so that PHP will always load the extension. Otherwise, you'll
have
> to call  at the beginning of any script you want
to
> use with Payflow Pro."
>
> Perhaps that's more information than necessary, but it covers the bulk of
> the difficulties that people run into using this extension. If this
> information could be incorporated into the PHP docs for this extension, I
> would be most grateful :)
>
> In any case, thanks for all your hard work on making PHP's docs the most
> accessible of any I've seen. Keep kicking ass :)
>
> -- 
> Justin M
> Technical Support
> VeriSign Payment Services
> [EMAIL PROTECTED]
> 888-883-9770


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

2004-07-31 Thread Nuno Lopes
nlopess Sat Jul 31 06:55:57 2004 EDT

  Modified files:  
/phpdoc/en/reference/pfpro  configure.xml 
  Log:
  added note about compiling as shared, by Justin Meyer
  
http://cvs.php.net/diff.php/phpdoc/en/reference/pfpro/configure.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/reference/pfpro/configure.xml
diff -u phpdoc/en/reference/pfpro/configure.xml:1.1 
phpdoc/en/reference/pfpro/configure.xml:1.2
--- phpdoc/en/reference/pfpro/configure.xml:1.1 Sun Dec  1 12:10:16 2002
+++ phpdoc/en/reference/pfpro/configure.xml Sat Jul 31 06:55:57 2004
@@ -1,11 +1,19 @@
 
-
+
 
  &reftitle.install;
  
   These functions are only available if PHP has been compiled with the
   --with-pfpro[=DIR] option.
  
+ 
+  
+   If you are planing to use this extension along with the OpenSSL extension or with ModSSL, you should
+   compile this extension as shared: --with-pfpro=shared,/usr/local.
+  
+ 
 
 
 

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

2004-07-31 Thread Gabor Hojtsy
- // or #
+ // or #, and /* */ on PHP 5
  comments
 
 
@@ -151,6 +151,11 @@
  floating point numbers
 
 
+ T_DOC_COMMENT
+ /** */
+ PHPDoc style 
comments
(in PHP 5) seems to be missing from here
Goba


Re: [PHP-DOC] PECL Doc questions

2004-07-31 Thread Gabor Hojtsy
I'm more referring to the future than today as at somepoint every 
PECL extension will have documentation.  I'll stop worrying
about it then as I most likely won't be downloading or building 
downloads for the PHP manual :)

The upcoming index format looks nice, and intuitive; and will
indeed help a great deal.
I thought a bit about the issues. Let me clear up a few things:
 Having PECL docs in the manual is cool for authors:
  - we have a ready made infrastructure
(translation groups, language dependant mailing lists,
a complete build system, revhcecks, fallbacks,
distribution system, etc.)
  - livedocs is primarily tested and developed on phpdoc,
so PECL docs have better testing
 Having PECL docs in the manual is good for readers:
  - they don't care where a function comes from, they may
install an extension, or their hosting provider does that
for them, and after that they just want to use it.
this provides a central place to get docs
  - the phpdocs have the best access infrastructure (shortcuts,
search facilities, panels, etc)
The MB size of the manual is not a problem for our users IMHO. The only 
problem is that the manual might get even harder to use with more 
extensions documented. We need to improve on useability anyway, this 
just emphasizes the need. It does not matter how big the manual is if it 
easy to navigate and find stuff in it.

Goba


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

2004-07-31 Thread Nuno Lopes
nlopess Sat Jul 31 06:02:17 2004 EDT

  Modified files:  
/phpdoc/en/appendices   tokens.xml 
  Log:
  document PHP 5 changes on comments
  
http://cvs.php.net/diff.php/phpdoc/en/appendices/tokens.xml?r1=1.12&r2=1.13&ty=u
Index: phpdoc/en/appendices/tokens.xml
diff -u phpdoc/en/appendices/tokens.xml:1.12 phpdoc/en/appendices/tokens.xml:1.13
--- phpdoc/en/appendices/tokens.xml:1.12Fri May 21 06:13:35 2004
+++ phpdoc/en/appendices/tokens.xml Sat Jul 31 06:02:17 2004
@@ -1,5 +1,5 @@
 
-
+
 
 
  List of Parser Tokens
@@ -93,7 +93,7 @@
 
 
  T_COMMENT
- // or #
+ // or #, and /* */ on PHP 5
  comments
 
 
@@ -151,6 +151,11 @@
  floating point numbers
 
 
+ T_DOC_COMMENT
+ /** */
+ PHPDoc style 
comments
+
+
  T_DO
  do
  do..while
@@ -385,7 +390,8 @@
 
  T_ML_COMMENT
  /* and */
- comments
+ comments
+  (PHP 4 only)
 
 
  T_MOD_EQUAL


[PHP-DOC] cvs: phpdoc /en/reference/strings/functions count-chars.xml

2004-07-31 Thread Dave
daveSat Jul 31 05:56:10 2004 EDT

  Modified files:  
/phpdoc/en/reference/strings/functions  count-chars.xml 
  Log:
  - Typo.
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/count-chars.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc/en/reference/strings/functions/count-chars.xml
diff -u phpdoc/en/reference/strings/functions/count-chars.xml:1.5 
phpdoc/en/reference/strings/functions/count-chars.xml:1.6
--- phpdoc/en/reference/strings/functions/count-chars.xml:1.5   Mon Oct 20 07:54:57 
2003
+++ phpdoc/en/reference/strings/functions/count-chars.xml   Sat Jul 31 05:56:10 
2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -18,7 +18,7 @@
 
  Counts the number of occurrences of every byte-value (0..255) in
  string and returns it in various ways.
- The optional parameter mode default to
+ The optional parameter mode defaults to
  0. Depending on mode
  count_chars returns one of the following:
  


[PHP-DOC] #29464 [Opn->Csd]: Typo in "Migrating to PHP5"

2004-07-31 Thread nlopess
 ID:   29464
 Updated by:   [EMAIL PROTECTED]
 Reported By:  phlipping at yahoo dot com
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: Windows
 PHP Version:  5.0.0
 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.

Fixed by Aidan.


Previous Comments:


[2004-07-31 04:01:33] phlipping at yahoo dot com

Description:

In http://www.php.net/manual/en/migration5.incompatible.php it says
that "T_ML_CONSTANT" has been removed - when in fact "T_ML_COMMENT" has
been removed






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