[PHP-DOC] Re: joint documentation site for php.net projects
Gabor Hojtsy wrote: Now I would like to ask you to just think about this a bit, and if you are interested in the development, please provide your opinion on how would it be best to discuss the further directions (crosspost replies, a designated mailing list, personal emails, IRC, or something else?) Have a nice day, Goba This seems like a GREAT idea, something I thought would never see the light of day :) I think a php-doc-web ML would be the best way to handle this. Additionally, IRC is always good too, for that instant gratification. - Davey
[PHP-DOC] #25208 [Opn->Ver]: Typos in the security chapter
ID: 25208
Updated by: [EMAIL PROTECTED]
Reported By: [EMAIL PROTECTED]
-Status: Open
+Status: Verified
Bug Type: Documentation problem
Operating System: Irrelevant
PHP Version: Irrelevant
Previous Comments:
[2003-08-22 07:21:27] [EMAIL PROTECTED]
Actually for XHTML/HTML Conformance, that first & *should* be an
& and so should the the second &.
Which brings about the question, should we start to change things like
this to bring examples upto standards compliant (X)HTML? Has the
decision been made whether HTML in the manual should be HTML or XHTML
yet?
He is right about the extraneous " after the 1 though.
- Davey
[2003-08-22 06:58:46] [EMAIL PROTECTED]
Description:
The second example included in the section `security.errors' ("Error
Reporting"), goes something like this:
There's a couple of errors in the `form' tag: (a) the `&' entity
shouldn't be there, and (b) there is one `"' too many.
Thanks.
--
Edit this bug report at http://bugs.php.net/?id=25208&edit=1
[PHP-DOC] #25208 [Opn]: Typos in the security chapter
ID: 25208
Updated by: [EMAIL PROTECTED]
Reported By: [EMAIL PROTECTED]
Status: Open
Bug Type: Documentation problem
Operating System: Irrelevant
PHP Version: Irrelevant
New Comment:
Actually for XHTML/HTML Conformance, that first & *should* be an
& and so should the the second &.
Which brings about the question, should we start to change things like
this to bring examples upto standards compliant (X)HTML? Has the
decision been made whether HTML in the manual should be HTML or XHTML
yet?
He is right about the extraneous " after the 1 though.
- Davey
Previous Comments:
[2003-08-22 06:58:46] [EMAIL PROTECTED]
Description:
The second example included in the section `security.errors' ("Error
Reporting"), goes something like this:
There's a couple of errors in the `form' tag: (a) the `&' entity
shouldn't be there, and (b) there is one `"' too many.
Thanks.
--
Edit this bug report at http://bugs.php.net/?id=25208&edit=1
[PHP-DOC] Re: #25036 [Opn->Bgs]: http://rohitfotedar.port5.com
Can we not put in some sort of cookie/session based time limit? i.e. you can only post one bug every 5 minutes? Some sort of filtering would be helpful also. - Davey -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions filetype.xml
davey Tue Jul 22 11:57:46 2003 EDT Modified files: /phpdoc/en/reference/filesystem/functions filetype.xml Log: added mime_content_type to see also Index: phpdoc/en/reference/filesystem/functions/filetype.xml diff -u phpdoc/en/reference/filesystem/functions/filetype.xml:1.7 phpdoc/en/reference/filesystem/functions/filetype.xml:1.8 --- phpdoc/en/reference/filesystem/functions/filetype.xml:1.7 Sat Feb 22 13:55:36 2003 +++ phpdoc/en/reference/filesystem/functions/filetype.xml Tue Jul 22 11:57:45 2003 @@ -1,5 +1,5 @@ - + @@ -28,8 +28,8 @@ See also: is_dir, is_file, - is_link, file_exists, and - stat. + is_link, file_exists, + stat, and mime_content_type. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] Re: Docmeeting Protocol
Derick Rethans wrote: On Wed, 16 Jul 2003, Davey wrote: Damien is going to help us with generating PDF straight from HTML to finally get it working. It will still need a full bightml file (generated with XSLT), but we will most likely hack up livedocs to makes this work. How are you going to be generating the PDF? Because it seems to me that going from XML->HTML->PDF is perhaps not the best way Why not use XSLT to go XML->XSL:FO and pass that through FOP to get the PDF? Sure, if you can donate a box with 4GB of ram :) Derick Fair enough ;) - Davey -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Re: Docmeeting Protocol
Damien is going to help us with generating PDF straight from HTML to finally get it working. It will still need a full bightml file (generated with XSLT), but we will most likely hack up livedocs to makes this work. How are you going to be generating the PDF? Because it seems to me that going from XML->HTML->PDF is perhaps not the best way Why not use XSLT to go XML->XSL:FO and pass that through FOP to get the PDF? - Davey Derick Rethans wrote: Hello, here a rough summary of the docmeeting which we had at LT, i've no more time to wrap it up nicely before I go on holiday, so perhaps somebody else can do that? I'm cc-ing pear-doc@ as they might be interested in using all of this too, but that will require some restructuring of the PEAR doc system. regards, Derick -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Re: Application
[EMAIL PROTECTED] wrote: Please see the attached zip file for details. Wez, An e-mail has been sent to php-doc ML, from your address, carrying a virus that has been hitting that list for a few weeks... if you are not running linux, perhaps you should run a virus scan... http://news.php.net/article.php?group=php.doc&article=969354950 is the virus affected message. - Davey -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Re: Time functions
[EMAIL PROTECTED] wrote: I'm not sure whether the date/time conversions of PHP use the locale of the browser or the locale of the server. Seems like the documentation ought to discuss that. - Steve -- Steve Benz ([EMAIL PROTECTED]) Tall Tree Software Co. 512-453-4909 Steve, PHP is serverside, is has no knowledge of the browser or its time locale. PHP *must* use the servers locale, it has knowledge of no other. - Davey -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Re: #24346 [Bgs->Opn]: ob_start wrongly optimized out when no callbackspecified
[EMAIL PROTECTED] wrote: ID: 24346 Updated by: [EMAIL PROTECTED] Reported By: pitrou at free dot fr -Status: Bogus +Status: Open -Bug Type: Output Control +Bug Type: Documentation problem Operating System: Linux PHP Version: 4.3.2 New Comment: It's indeed a change, but still, it's right as it is now. I'm changing this to a doc problem: 1. the return value is not documented 2. this function can also be used with the array() syntax to call methods of an object. This is to do with the callbacks documentation stuff I am working on... will you do that yourself? or wait for me to get to it? I think I *may* have document ob_start() already just I'm planning to do one huge (verified) commit rather than commiting each as I go along. - Davey -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] Callbacks
Hartmut Holzgraefe wrote: Davey wrote: I am fine with the callback type, and the "handler" name to use for callback paramater names. Goba It seems that "callback" and "handler" are well recieved, would you like for me to go through and change all functions which use callbacks to have this? IMHO "handler" only makes sense where one can't come up with another more descriptive parameter name for the callback function/method passed ... take the usort() function for an example, its current prototype is void usort ( array array, callback cmp_function) if you changed it to void usort ( array array, callback handler) you lose a *lot* of information on what the function does ... I will keep that in mind. I'll try to use descriptive names where possible, and I won't remove any names unless they are currently "callback". - Davey -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] Callbacks
Gabor Hojtsy wrote: As you can see, one is using callback the other mixed, the reasons being obvious - a callback is just a string or an array... so the question here is, do we respect the callback type as its own which consists of 'mixed' data, or do we use mixed? I personally feel that callback is more descriptive. as I am going through all callback functions anyways, I will change them all to have the same, whatever is decided. I'm not entirely bothered which is chosen, so long as one is, and its stuck too. I am fine with the callback type, and the "handler" name to use for callback paramater names. Goba It seems that "callback" and "handler" are well recieved, would you like for me to go through and change all functions which use callbacks to have this? I am going to go through all the functions anyways as I mentioned in my original e-mail, doing this is little extra work I don't mind doing. Just tell me when you gurus have reached a final decision on what should be used and I'll get right on it :) - Davey -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Callbacks
Hey all, I've been talking to a few other phpdoc'ers about this subject, namely philip and Pollita (aswell as Joey Smith/TML). I was a bit perplexed about the way callbacks was handled in the manual, with there never being a definition (as such) of what one is, and how to use them. I was going to write this, but philip then found pretty much exactly what needs to be said in types.xml (language.types.callback - child of the language.pseudo-types section). Once that was done, I said that this should be referenced wherever callbacks are used, to keep it all uniform and neat, rather than each function that uses callbacks either having a copy and paste or a completely new piece of text on callbacks. At this point, philip said that I should be using callback in the documentation and that it would link dynamically... fair enough, I set to work, on an all at once commit for all functions that use callbacks. (as philip requested) Then I stumbled across an incosistency, and after discussing with Pollita and philip in #php.doc (EFnet) it was suggested I post here to ask the general opinion. Here is the problem: array-map.xml mixedcallback ob-start.xml callback output_callback As you can see, one is using callback the other mixed, the reasons being obvious - a callback is just a string or an array... so the question here is, do we respect the callback type as its own which consists of 'mixed' data, or do we use mixed? I personally feel that callback is more descriptive. as I am going through all callback functions anyways, I will change them all to have the same, whatever is decided. I'm not entirely bothered which is chosen, so long as one is, and its stuck too. I appreciate your thoughts on the entire contents of this e-mail, not just the type stuff in the latter parts. - Davey -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/language types.xml
davey Thu Jun 19 18:29:12 2003 EDT Modified files: /phpdoc/en/language types.xml Log: added & to object callback example, changed example to be more verbose and easier to follow Index: phpdoc/en/language/types.xml diff -u phpdoc/en/language/types.xml:1.119 phpdoc/en/language/types.xml:1.120 --- phpdoc/en/language/types.xml:1.119 Wed Jun 18 19:02:30 2003 +++ phpdoc/en/language/types.xmlThu Jun 19 18:29:12 2003 @@ -1,5 +1,5 @@ - + Types @@ -2244,24 +2244,24 @@ -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/posix/functions posix-getcwd.xml
davey Thu Jun 19 15:49:07 2003 EDT Modified files: /phpdoc/en/reference/posix/functionsposix-getcwd.xml Log: added documentation, abstracted from 'man getcwd' Index: phpdoc/en/reference/posix/functions/posix-getcwd.xml diff -u phpdoc/en/reference/posix/functions/posix-getcwd.xml:1.4 phpdoc/en/reference/posix/functions/posix-getcwd.xml:1.5 --- phpdoc/en/reference/posix/functions/posix-getcwd.xml:1.4Thu Jun 19 15:47:45 2003 +++ phpdoc/en/reference/posix/functions/posix-getcwd.xmlThu Jun 19 15:49:07 2003 @@ -1,5 +1,5 @@ - + @@ -13,7 +13,9 @@ - &warn.undocumented.func; + posix_getcwd returns the absolute pathname of the + scripts current working directory. posix_getcwd + returns &false; on error. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/posix/functions posix-getcwd.xml
davey Thu Jun 19 15:47:45 2003 EDT Modified files: /phpdoc/en/reference/posix/functionsposix-getcwd.xml Log: whitespace correction Index: phpdoc/en/reference/posix/functions/posix-getcwd.xml diff -u phpdoc/en/reference/posix/functions/posix-getcwd.xml:1.3 phpdoc/en/reference/posix/functions/posix-getcwd.xml:1.4 --- phpdoc/en/reference/posix/functions/posix-getcwd.xml:1.3Mon Jan 27 21:33:22 2003 +++ phpdoc/en/reference/posix/functions/posix-getcwd.xmlThu Jun 19 15:47:45 2003 @@ -1,5 +1,5 @@ - + @@ -8,11 +8,11 @@ Description - - stringposix_getcwd - - - + + stringposix_getcwd + + + &warn.undocumented.func; -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/posix/functions posix-strerror.xml
davey Thu Jun 19 15:02:02 2003 EDT Modified files: /phpdoc/en/reference/posix/functionsposix-strerror.xml Log: removed extraneous 'commonly' - there is no other way. Even if there is, it reads better without. Index: phpdoc/en/reference/posix/functions/posix-strerror.xml diff -u phpdoc/en/reference/posix/functions/posix-strerror.xml:1.1 phpdoc/en/reference/posix/functions/posix-strerror.xml:1.2 --- phpdoc/en/reference/posix/functions/posix-strerror.xml:1.1 Wed May 21 19:54:59 2003 +++ phpdoc/en/reference/posix/functions/posix-strerror.xml Thu Jun 19 15:02:02 2003 @@ -1,5 +1,5 @@ - + posix_strerror @@ -17,7 +17,7 @@ Returns the POSIX system error message associated with the given errno. If errno is 0, then the string "Success" is returned. The function posix_get_last_error is - commonly used for retrieving the last POSIX errno. + used for retrieving the last POSIX errno. See also posix_get_last_error. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/funchand/functions register-tick-function.xml
davey Tue Jun 17 19:57:57 2003 EDT Modified files: /phpdoc/en/reference/funchand/functions register-tick-function.xml Log: added See Also Index: phpdoc/en/reference/funchand/functions/register-tick-function.xml diff -u phpdoc/en/reference/funchand/functions/register-tick-function.xml:1.5 phpdoc/en/reference/funchand/functions/register-tick-function.xml:1.6 --- phpdoc/en/reference/funchand/functions/register-tick-function.xml:1.5 Tue Jun 17 19:45:58 2003 +++ phpdoc/en/reference/funchand/functions/register-tick-function.xml Tue Jun 17 19:57:57 2003 @@ -1,5 +1,5 @@ - + @@ -38,6 +38,10 @@ ]]> + + + See also declare and + unregister_tick_function. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/funchand/functions register-tick-function.xml
davey Tue Jun 17 19:45:59 2003 EDT Modified files: /phpdoc/en/reference/funchand/functions register-tick-function.xml Log: fixed various errors and changed the wording slightly (thanks philip) Index: phpdoc/en/reference/funchand/functions/register-tick-function.xml diff -u phpdoc/en/reference/funchand/functions/register-tick-function.xml:1.4 phpdoc/en/reference/funchand/functions/register-tick-function.xml:1.5 --- phpdoc/en/reference/funchand/functions/register-tick-function.xml:1.4 Tue Jun 17 19:02:06 2003 +++ phpdoc/en/reference/funchand/functions/register-tick-function.xml Tue Jun 17 19:45:58 2003 @@ -1,5 +1,5 @@ - + @@ -19,26 +19,26 @@ Registers the function named by func to be executed when a tick is - called. + called. Also, you may pass an array consisting of an object and a + method as the func. - - You may also pass an array consisting of an object and a method as the func - - - register_tick_function Example - + + + register_tick_function example + - - + + + -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] #23849 [Asn]: Errors in various doc pages
ID: 23849
Updated by: [EMAIL PROTECTED]
Reported By: [EMAIL PROTECTED]
Status: Assigned
Bug Type: Documentation problem
Operating System: N/A
-PHP Version: 4.3.2RC4
+PHP Version: 4.3.2
Assigned To: davey
New Comment:
socket_set_timeout - fixed in CVS
declare - fixed in CVS
register_tick_function - fixed in CVS
pcntl_waitpic - fixed in CVS
socket_send - fixed in CVS
socket_sendto - fixed in CVS
socket_shutdown - fixed in CVS
still working on the rest
- Davey
Previous Comments:
[2003-05-28 06:51:23] [EMAIL PROTECTED]
OK, these are just small errors I've been noticing:
socket_set_timeout() - last argument is optional and is no shown as
such
declare() - does not need to be called as a statement, this is valid:
declare(ticks=1);
rest of pages code here;
in which case its the same as doing:
declare(ticks=1) {
rest of pages code here;
}
meaning that in the first, the ticks is on all the code following,
whereas with the second you can have it only work for the code inside
the statement.
register_tick_function - this does not state you use an object method
as the callback method (using array(&$object,'method')
pcntl_waitpid - second argument should be noted as a reference (i.e.
int &status)
Thats all I can remember right now, apart from the following need full
docs:
pcntl_exec()
posix_ctermid()
posix_getcwd()
posix_getgrgid()
posix_getgrname()
posix_getrlimit()
posix_isatty()
posix_ttyname()
socket_get_option()
socket_iovec_*()
socket_readv()
socket_recv*()
socket_send*()
socket_set_nonblock()
socket_set_option()
socket_shutdown()
socket_writev()
quite a list. I would gladly help provide some documentation either as
DocBook XML (as best I can, I'm still very new to it) or plaintext for
you convert to DocBook...
- Davey
--
Edit this bug report at http://bugs.php.net/?id=23849&edit=1
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/funchand/functions register-tick-function.xml
davey Tue Jun 17 19:02:06 2003 EDT Modified files: /phpdoc/en/reference/funchand/functions register-tick-function.xml Log: added example and documentated using an object->method as the callback Index: phpdoc/en/reference/funchand/functions/register-tick-function.xml diff -u phpdoc/en/reference/funchand/functions/register-tick-function.xml:1.3 phpdoc/en/reference/funchand/functions/register-tick-function.xml:1.4 --- phpdoc/en/reference/funchand/functions/register-tick-function.xml:1.3 Sat Oct 26 16:40:42 2002 +++ phpdoc/en/reference/funchand/functions/register-tick-function.xml Tue Jun 17 19:02:06 2003 @@ -1,5 +1,5 @@ - + @@ -19,7 +19,26 @@ Registers the function named by func to be executed when a tick is - called. + called. + + + You may also pass an array consisting of an object and a method as the func + + + register_tick_function Example + + + + -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/strings/functions str-ireplace.xml
davey Mon Jun 16 11:14:47 2003 EDT Modified files: /phpdoc/en/reference/strings/functions str-ireplace.xml Log: changed example to actually use str_ireplace() instead of str_replace Index: phpdoc/en/reference/strings/functions/str-ireplace.xml diff -u phpdoc/en/reference/strings/functions/str-ireplace.xml:1.3 phpdoc/en/reference/strings/functions/str-ireplace.xml:1.4 --- phpdoc/en/reference/strings/functions/str-ireplace.xml:1.3 Fri May 30 12:47:59 2003 +++ phpdoc/en/reference/strings/functions/str-ireplace.xml Mon Jun 16 11:14:47 2003 @@ -1,5 +1,5 @@ - + @@ -50,7 +50,7 @@ -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/language control-structures.xml
davey Tue Jun 3 19:06:56 2003 EDT Modified files: /phpdoc/en/language control-structures.xml Log: Added documentation and example of how declare can be used in the global scope. Index: phpdoc/en/language/control-structures.xml diff -u phpdoc/en/language/control-structures.xml:1.73 phpdoc/en/language/control-structures.xml:1.74 --- phpdoc/en/language/control-structures.xml:1.73 Sat May 31 23:55:58 2003 +++ phpdoc/en/language/control-structures.xml Tue Jun 3 19:06:56 2003 @@ -1,5 +1,5 @@ - + Control Structures @@ -925,6 +925,26 @@ it is executed and what side effects occur during execution may depend on the directive set in the directive block. + + +The declare construct can also be used in the global +scope, affecting all code following it. + + + + + Ticks -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/stream/functions stream-set-timeout.xml
davey Tue Jun 3 12:58:24 2003 EDT Modified files: /phpdoc/en/reference/stream/functions stream-set-timeout.xml Log: changed 3rd arg (microseconds) to optional Index: phpdoc/en/reference/stream/functions/stream-set-timeout.xml diff -u phpdoc/en/reference/stream/functions/stream-set-timeout.xml:1.1 phpdoc/en/reference/stream/functions/stream-set-timeout.xml:1.2 --- phpdoc/en/reference/stream/functions/stream-set-timeout.xml:1.1 Thu Jan 2 21:41:14 2003 +++ phpdoc/en/reference/stream/functions/stream-set-timeout.xml Tue Jun 3 12:58:24 2003 @@ -1,5 +1,5 @@ - + @@ -12,7 +12,7 @@ boolstream_set_timeout resourcestream intseconds - intmicroseconds + intmicroseconds Sets the timeout value on stream, -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] #23849 [Opn->Asn]: pear package not including correct files
ID: 23849
Updated by: [EMAIL PROTECTED]
-Summary: Errors in various doc pages
Reported By: [EMAIL PROTECTED]
-Status: Open
+Status: Assigned
Bug Type: Documentation problem
Operating System: N/A
PHP Version: 4.3.2RC4
-Assigned To:
+Assigned To: davey
Previous Comments:
[2003-05-28 06:51:23] [EMAIL PROTECTED]
OK, these are just small errors I've been noticing:
socket_set_timeout() - last argument is optional and is no shown as
such
declare() - does not need to be called as a statement, this is valid:
declare(ticks=1);
rest of pages code here;
in which case its the same as doing:
declare(ticks=1) {
rest of pages code here;
}
meaning that in the first, the ticks is on all the code following,
whereas with the second you can have it only work for the code inside
the statement.
register_tick_function - this does not state you use an object method
as the callback method (using array(&$object,'method')
pcntl_waitpid - second argument should be noted as a reference (i.e.
int &status)
Thats all I can remember right now, apart from the following need full
docs:
pcntl_exec()
posix_ctermid()
posix_getcwd()
posix_getgrgid()
posix_getgrname()
posix_getrlimit()
posix_isatty()
posix_ttyname()
socket_get_option()
socket_iovec_*()
socket_readv()
socket_recv*()
socket_send*()
socket_set_nonblock()
socket_set_option()
socket_shutdown()
socket_writev()
quite a list. I would gladly help provide some documentation either as
DocBook XML (as best I can, I'm still very new to it) or plaintext for
you convert to DocBook...
- Davey
--
Edit this bug report at http://bugs.php.net/?id=23849&edit=1
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/shmop/functions shmop-open.xml
davey Thu May 29 20:36:55 2003 EDT Modified files: /phpdoc/en/reference/shmop/functionsshmop-open.xml Log: fixed some whitespace issues Index: phpdoc/en/reference/shmop/functions/shmop-open.xml diff -u phpdoc/en/reference/shmop/functions/shmop-open.xml:1.3 phpdoc/en/reference/shmop/functions/shmop-open.xml:1.4 --- phpdoc/en/reference/shmop/functions/shmop-open.xml:1.3 Thu May 29 19:22:51 2003 +++ phpdoc/en/reference/shmop/functions/shmop-open.xml Thu May 29 20:36:55 2003 @@ -1,5 +1,5 @@ - + @@ -26,29 +26,32 @@ "a" for access (sets SHM_RDONLY for shmat) -use this flag when you need to open an existing shared memory segment for read only +use this flag when you need to open an existing shared memory +segment for read only "c" for create (sets IPC_CREATE) -use this flag when you need to create a new shared memory segment or if a -segment with the same key exists, try to open it for read and write +use this flag when you need to create a new shared memory segment +or if a segment with the same key exists, try to open it for read +and write "w" for read & write access -use this flag when you need to read and write to a shared memory segment, use this flag -in most cases. +use this flag when you need to read and write to a shared memory +segment, use this flag in most cases. "n" create a new memory segment (sets IPC_CREATE|IPC_EXCL) -use this flag when you want to create a new shared memory segment but if one -already exists with the same flag, fail. This is useful for security purposes, using this you -can prevent race condition exploits. +use this flag when you want to create a new shared memory segment +but if one already exists with the same flag, fail. This is useful +for security purposes, using this you can prevent race condition +exploits. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] cvs: phpdoc /en/reference/shmop/functions shmop-open.xml
Does the attached diff fix what you spotted? I can see nothing else. If I missed it, please enlighten me so as I won't do it again. - Dave Mehdi wrote: Hi davey and welcome ;) Your commit had some WS issues, can you correct them ? didou davey Thu May 29 19:22:51 2003 EDT Modified files: /phpdoc/en/reference/shmop/functions shmop-open.xml Log: changed example so that it uses ftok() instead of a static key Index: phpdoc/en/reference/shmop/functions/shmop-open.xml diff -u phpdoc/en/reference/shmop/functions/shmop-open.xml:1.2 phpdoc/en/reference/shmop/functions/shmop-open.xml:1.3 --- phpdoc/en/reference/shmop/functions/shmop-open.xml:1.2 Wed Apr 17 02:44:02 2002 +++ phpdoc/en/reference/shmop/functions/shmop-open.xml Thu May 29 19:22:51 2003 @@ -1,5 +1,5 @@ - + @@ -33,22 +33,22 @@ "c" for create (sets IPC_CREATE) use this flag when you need to create a new shared memory segment or if a - segment with the same key exists, try to open it for read and write + segment with the same key exists, try to open it for read and write "w" for read & write access - use this flag when you need to read and write to a shared memory segment, use this flag -in most cases. +use this flag when you need to read and write to a shared memory segment, use this flag +in most cases. "n" create a new memory segment (sets IPC_CREATE|IPC_EXCL) - use this flag when you want to create a new shared memory segment but if one -already exists with the same flag, fail. This is useful for security purposes, using this you - can prevent race condition exploits. +use this flag when you want to create a new shared memory segment but if one +already exists with the same flag, fail. This is useful for security purposes, using this you +can prevent race condition exploits. @@ -70,14 +70,16 @@ - This example opened a shared memory block with a system id of 0x0fff. + This example opened a shared memory block with a system id returned by + ftok. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php Index: c:/web/php-cvs/phpdoc/en/reference/shmop/functions/shmop-open.xml === RCS file: /repository/phpdoc/en/reference/shmop/functions/shmop-open.xml,v retrieving revision 1.3 diff -u -r1.3 shmop-open.xml --- c:/web/php-cvs/phpdoc/en/reference/shmop/functions/shmop-open.xml 29 May 2003 23:22:51 - 1.3 +++ c:/web/php-cvs/phpdoc/en/reference/shmop/functions/shmop-open.xml 29 May 2003 23:46:35 - @@ -26,29 +26,32 @@ "a" for access (sets SHM_RDONLY for shmat) -use this flag when you need to open an existing shared memory segment for read only +use this flag when you need to open an existing shared memory +segment for read only "c" for create (sets IPC_CREATE) -use this flag when you need to create a new shared memory segment or if a -segment with the same key exists, try to open it for read and write +use this flag when you need to create a new shared memory segment +or if a segment with the same key exists, try to open it for read +and write "w" for read & write access -use this flag when you need to read and write to a shared memory segment, use this flag -in most cases. +use this flag when you need to read and write to a shared memory +segment, use this flag in most cases. "n" create a new memory segment (sets IPC_CREATE|IPC_EXCL) -use this flag when you want to create a new shared memory segment but if one -already exists with the same flag, fail. This is useful for security purposes, using this you -can prevent race condition exploits. +use this flag when you want to create a new shared memory segment +but if one already exists with the same flag, fail. This is useful +for security purposes, using this you can prevent race condition +exploits. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/shmop/functions shmop-open.xml
davey Thu May 29 19:22:51 2003 EDT Modified files: /phpdoc/en/reference/shmop/functionsshmop-open.xml Log: changed example so that it uses ftok() instead of a static key Index: phpdoc/en/reference/shmop/functions/shmop-open.xml diff -u phpdoc/en/reference/shmop/functions/shmop-open.xml:1.2 phpdoc/en/reference/shmop/functions/shmop-open.xml:1.3 --- phpdoc/en/reference/shmop/functions/shmop-open.xml:1.2 Wed Apr 17 02:44:02 2002 +++ phpdoc/en/reference/shmop/functions/shmop-open.xml Thu May 29 19:22:51 2003 @@ -1,5 +1,5 @@ - + @@ -33,22 +33,22 @@ "c" for create (sets IPC_CREATE) use this flag when you need to create a new shared memory segment or if a - segment with the same key exists, try to open it for read and write +segment with the same key exists, try to open it for read and write "w" for read & write access - use this flag when you need to read and write to a shared memory segment, use this flag - in most cases. +use this flag when you need to read and write to a shared memory segment, use this flag +in most cases. "n" create a new memory segment (sets IPC_CREATE|IPC_EXCL) - use this flag when you want to create a new shared memory segment but if one - already exists with the same flag, fail. This is useful for security purposes, using this you - can prevent race condition exploits. +use this flag when you want to create a new shared memory segment but if one +already exists with the same flag, fail. This is useful for security purposes, using this you +can prevent race condition exploits. @@ -70,14 +70,16 @@ - This example opened a shared memory block with a system id of 0x0fff. + This example opened a shared memory block with a system id returned by + ftok. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] cvs: phpdoc /en/reference/pcntl/functions pcntl-waitpid.xml
You are of course right, as as an XHMTL/XML/XSLT standards advocate and user, I should have known this. Rather than submit this patch here how do I request CVS access to phpdoc? who should I ask? - Davey Philip Olson wrote: You must use & here, not & Regards, Philip On Thu, 29 May 2003, Andrew Lindeman wrote: alindeman Thu May 29 08:44:03 2003 EDT Modified files: /phpdoc/en/reference/pcntl/functions pcntl-waitpid.xml Log: applying davey's ([EMAIL PROTECTED]) patch Index: phpdoc/en/reference/pcntl/functions/pcntl-waitpid.xml diff -u phpdoc/en/reference/pcntl/functions/pcntl-waitpid.xml:1.2 phpdoc/en/reference/pcntl/functions/pcntl-waitpid.xml:1.3 --- phpdoc/en/reference/pcntl/functions/pcntl-waitpid.xml:1.2 Wed Apr 17 02:42:45 2002 +++ phpdoc/en/reference/pcntl/functions/pcntl-waitpid.xml Thu May 29 08:44:03 2003 @@ -1,5 +1,5 @@ - + @@ -11,7 +11,7 @@ intpcntl_waitpid intpid - intstatus + int&status intoptions -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] pcntl_waitpid - small change
Small change in these docs, parameter 'status' is a reference, added the & to the synopsis :) - Davey Index: pcntl-waitpid.xml === RCS file: /repository/phpdoc/en/reference/pcntl/functions/pcntl-waitpid.xml,v retrieving revision 1.2 diff -u -r1.2 pcntl-waitpid.xml --- pcntl-waitpid.xml 17 Apr 2002 06:42:45 - 1.2 +++ pcntl-waitpid.xml 29 May 2003 12:25:27 - @@ -11,7 +11,7 @@ intpcntl_waitpid intpid - intstatus + int&status intoptions -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] sockets/constants.xml and socket_create doc changes
Here are some small changes to these docs. (attached!) - Davey Index: socket-create.xml === RCS file: /repository/phpdoc/en/reference/sockets/functions/socket-create.xml,v retrieving revision 1.5 diff -u -r1.5 socket-create.xml --- socket-create.xml 17 Apr 2003 21:44:32 - 1.5 +++ socket-create.xml 28 May 2003 22:15:42 - @@ -118,8 +118,8 @@ protocol within the specified domain to be used when communicating on the returned socket. The proper value can be retrieved by name by using getprotobyname. If - the desired protocol is TCP, or UDP the corresponding constants - SOL_TCP, and SOL_UDP + the desired protocol is TCP, UDP or a Unix SOCKET the corresponding constants + SOL_TCP, SOL_UDP and SOL_SOCKET can also be used. Index: constants.xml === RCS file: /repository/phpdoc/en/reference/sockets/constants.xml,v retrieving revision 1.2 diff -u -r1.2 constants.xml --- constants.xml 17 Apr 2003 21:44:32 - 1.2 +++ constants.xml 28 May 2003 22:13:53 - @@ -303,7 +303,7 @@ -SOL_SOCKET +PHP_NORMAL_READ (integer) @@ -314,7 +314,7 @@ -PHP_NORMAL_READ +PHP_BINARY_READ (integer) @@ -325,7 +325,7 @@ -PHP_BINARY_READ +SOL_SOCKET (integer) -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Re: socket_sendto docs
Davey wrote: Heres the diff, added an example so its a bit more complex, hope its OK: And again with better whitespace in the example, the extraneous removed and the missing ) on socket_close($sh); put in! - Davey Index: socket-sendto.xml === RCS file: /repository/phpdoc/en/reference/sockets/functions/socket-sendto.xml,v retrieving revision 1.2 diff -u -r1.2 socket-sendto.xml --- socket-sendto.xml 17 Apr 2002 06:44:10 - 1.2 +++ socket-sendto.xml 28 May 2003 21:53:33 - @@ -19,7 +19,75 @@ &warn.experimental.func; - &warn.undocumented.func; + The function socket_sendto sends + len bytes from buf + through the socket socket to the + port at the address addr + + + The value of flags can be one of the + following: + + possible values for flags + + + + 0x1 + + process out-of-band data + + + + 0x2 + + peek at incoming message + + + + 0x4 + + bypass routing, use direct interface + + + + 0x8 + + data completes record + + + + 0x100 + + data completes transaction + + + + + + + + socket_sendto Example + + + + + + See also + socket_send and + socket_sendmsg. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Re: socket_sendto docs
Davey wrote: Heres the diff, added an example so its a bit more complex, hope its OK: and here it is attached instead of in-line, I *will* get it right next time :) - Davey Index: socket-sendto.xml === RCS file: /repository/phpdoc/en/reference/sockets/functions/socket-sendto.xml,v retrieving revision 1.2 diff -u -r1.2 socket-sendto.xml --- socket-sendto.xml 17 Apr 2002 06:44:10 - 1.2 +++ socket-sendto.xml 28 May 2003 21:47:00 - @@ -19,7 +19,76 @@ &warn.experimental.func; - &warn.undocumented.func; + The function socket_sendto sends + len bytes from buf + through the socket socket to the + port at the address addr + + + The value of flags can be one of the + following: + + possible values for flags + + + + 0x1 + + process out-of-band data + + + + 0x2 + + peek at incoming message + + + + 0x4 + + bypass routing, use direct interface + + + + 0x8 + + data completes record + + + + 0x100 + + data completes transaction + + + + + + + + socket_sendto Example + + + + + + See also + socket_send and + socket_sendmsg. + -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] socket_sendto docs
Heres the diff, added an example so its a bit more complex, hope its OK: Index: socket-sendto.xml === RCS file: /repository/phpdoc/en/reference/sockets/functions/socket-sendto.xml,v retrieving revision 1.2 diff -u -r1.2 socket-sendto.xml --- socket-sendto.xml 17 Apr 2002 06:44:10 - 1.2 +++ socket-sendto.xml 28 May 2003 21:47:00 - @@ -19,7 +19,76 @@ &warn.experimental.func; - &warn.undocumented.func; + The function socket_sendto sends + len bytes from buf + through the socket socket to the + port at the address addr + + + The value of flags can be one of the + following: + + possible values for flags + + + + 0x1 + + process out-of-band data + + + + 0x2 + + peek at incoming message + + + + 0x4 + + bypass routing, use direct interface + + + + 0x8 + + data completes record + + + + 0x100 + + data completes transaction + + + + + + + + socket_sendto Example + + + + + + See also + socket_send and + socket_sendmsg. + - Davey -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] socket_send diff
Here you go, hope this is OK - Davey Index: socket-send.xml === RCS file: /repository/phpdoc/en/reference/sockets/functions/socket-send.xml,v retrieving revision 1.2 diff -u -r1.2 socket-send.xml --- socket-send.xml 17 Apr 2002 06:44:10 - 1.2 +++ socket-send.xml 28 May 2003 21:34:39 - @@ -17,7 +17,55 @@ &warn.experimental.func; - &warn.undocumented.func; + The function socket_send sends + len bytes to the socket + socket from buf + + + The value of flags can be one of the + following: + + possible values for flags + + + + 0x1 + + process out-of-band data + + + + 0x2 + + peek at incoming message + + + + 0x4 + + bypass routing, use direct interface + + + + 0x8 + + data completes record + + + + 0x100 + + data completes transaction + + + + + + + + See also + socket_sendmsg and + socket_sendto. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Re: socket_send docs
Oops, I made a mistake (a redundant 'to'), heres the new diff:
Index: socket-send.xml
===
RCS file:
/repository/phpdoc/en/reference/sockets/functions/socket-send.xml,v
retrieving revision 1.2
diff -u -r1.2 socket-send.xml
--- socket-send.xml 17 Apr 2002 06:44:10 - 1.2
+++ socket-send.xml 28 May 2003 21:21:28 -
@@ -10,14 +10,74 @@
Description
intsocket_send
-
resourcesocket
-
stringbuf
- intlen
-
intflags
+
+ resource
+ socket
+
+
+ string
+ buf
+
+
+ int
+ len
+
+
+ int
+ flags
+
&warn.experimental.func;
- &warn.undocumented.func;
+ The function socket_send sends
+ len bytes to the socket
+ socket from buf
+
+
+ The value of flags can be one of the
+ following:
+
+ possible values for flags
+
+
+
+ 0x1
+
+ process out-of-band data
+
+
+
+ 0x2
+
+ peek at incoming message
+
+
+
+ 0x4
+
+ bypass routing, use direct interface
+
+
+
+ 0x8
+
+ data completes record
+
+
+
+ 0x100
+
+ data completes transaction
+
+
+
+
+
+
+
+ See also
+ socket_sendmsg and
+ socket_sendto.
Davey wrote:
heres a small diff for the socket_send documentation for someone to commit.
Pollita already commited by socket_shutdown docs, I'm working on quite a
few others, will have socket_sendmsg and socket_sendto done pretty
quickly, they're pretty much the same as this.
Will consider asking for phpdoc karma if my DocBook skills are upto
scratch (thats upto you to judge!) - do I ask here of do I need to ask
from the php website as with my pear karma?
- Davey
Index: socket-send.xml
===
RCS file:
/repository/phpdoc/en/reference/sockets/functions/socket-send.xml,v
retrieving revision 1.2
diff -u -r1.2 socket-send.xml
--- socket-send.xml17 Apr 2002 06:44:10 -1.2
+++ socket-send.xml28 May 2003 20:34:03 -
@@ -10,14 +10,74 @@
Description
intsocket_send
-
resourcesocket
- stringbuf
-
intlen
- intflags
+
+ resource
+ socket
+
+
+ string
+ buf
+
+
+ int
+ len
+
+
+ int
+ flags
+
&warn.experimental.func;
- &warn.undocumented.func;
+ The function socket_send sends to
+ len bytes to the socket
+ socket from buf
+
+
+ The value of flags can be one of the
+ following:
+
+ possible values for flags
+
+
+
+ 0x1
+
+ process out-of-band data
+
+
+
+ 0x2
+
+ peek at incoming message
+
+
+
+ 0x4
+
+ bypass routing, use direct interface
+
+
+
+ 0x8
+
+ data completes record
+
+
+
+ 0x100
+
+ data completes transaction
+
+
+
+
+
+
+
+ See also
+ socket_sendmsg and
+ socket_sendto.
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] socket_send docs
heres a small diff for the socket_send documentation for someone to commit. Pollita already commited by socket_shutdown docs, I'm working on quite a few others, will have socket_sendmsg and socket_sendto done pretty quickly, they're pretty much the same as this. Will consider asking for phpdoc karma if my DocBook skills are upto scratch (thats upto you to judge!) - do I ask here of do I need to ask from the php website as with my pear karma? - Davey Index: socket-send.xml === RCS file: /repository/phpdoc/en/reference/sockets/functions/socket-send.xml,v retrieving revision 1.2 diff -u -r1.2 socket-send.xml --- socket-send.xml 17 Apr 2002 06:44:10 - 1.2 +++ socket-send.xml 28 May 2003 20:34:03 - @@ -10,14 +10,74 @@ Description intsocket_send - resourcesocket - stringbuf - intlen - intflags + + resource + socket + + + string + buf + + + int + len + + + int + flags + &warn.experimental.func; - &warn.undocumented.func; + The function socket_send sends to + len bytes to the socket + socket from buf + + + The value of flags can be one of the + following: + + possible values for flags + + + + 0x1 + + process out-of-band data + + + + 0x2 + + peek at incoming message + + + + 0x4 + + bypass routing, use direct interface + + + + 0x8 + + data completes record + + + + 0x100 + + data completes transaction + + + + + + + + See also + socket_sendmsg and + socket_sendto. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Re: Full PDF Manual for 4.2.2
Hey,
I was able to create the full PDF using a copy of
Adobe Acrobat 5 on winXP. Nothing sophisticated or special linux
tools.
If you wish, I don't mind contributing future PDF
manuals to the site, I just create it from the HTML (many files) version.
- Davey
- Original Message -
From:
Gabor Hojtsy
To: Davey ; [EMAIL PROTECTED] ; [EMAIL PROTECTED]
Sent: Friday, September 06, 2002 10:03
PM
Subject: Re: Full PDF Manual for
4.2.2
Please tell us how you were able to compile this,
as we would be quite
happy to hear any tips on how to generate such a
big PDF. Our tools can't handle the size...
[Please use reply all!]
Goba [one [EMAIL PROTECTED]]
- Original Message -
From:
Davey
To: [EMAIL PROTECTED]
Sent: Friday, September 06, 2002 8:11
AM
Subject: Full PDF Manual for
4.2.2
Hey,
I have created a full PDF version of the
current 4.2.2 Manual. It includes links to navigate around the document too
(like from the contents to the sections, and from the sections to the next
one etc)
I hope that you will put this up on the php.net
website for download by others.
You can find it gzipped here:
http://www.its-explosive.net/~davey/php_manual_en.pdf.gz
It's 6.5MB compressed and closed to 20MB
uncompressed. I hope it helps you and the community a little
-
Davey
