[PHP-DOC] cvs: phpdoc /en/reference/array/functions in-array.xml
philip Wed Jun 11 02:21:32 2003 EDT Modified files: /phpdoc/en/reference/array/functionsin-array.xml Log: Fix refpurpose Index: phpdoc/en/reference/array/functions/in-array.xml diff -u phpdoc/en/reference/array/functions/in-array.xml:1.6 phpdoc/en/reference/array/functions/in-array.xml:1.7 --- phpdoc/en/reference/array/functions/in-array.xml:1.6Fri May 30 14:07:51 2003 +++ phpdoc/en/reference/array/functions/in-array.xmlWed Jun 11 02:21:32 2003 @@ -1,10 +1,10 @@ - + in_array -Return &true; if a value exists in an array +Checks if a value exists in an array Description -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/session/functions session-register.xml
philip Wed Jun 11 00:38:52 2003 EDT Modified files: /phpdoc/en/reference/session/functions session-register.xml Log: Link to $_SESSION docs, added ¬e.registerglobals; entity, and some example comments. Index: phpdoc/en/reference/session/functions/session-register.xml diff -u phpdoc/en/reference/session/functions/session-register.xml:1.8 phpdoc/en/reference/session/functions/session-register.xml:1.9 --- phpdoc/en/reference/session/functions/session-register.xml:1.8 Fri Jan 31 14:14:58 2003 +++ phpdoc/en/reference/session/functions/session-register.xml Wed Jun 11 00:38:52 2003 @@ -1,5 +1,5 @@ - + @@ -25,16 +25,20 @@ If you want your script to work regardless of register_globals, - you need to use the $_SESSION array. All - $_SESSION entries are automatically + linkend="ini.register-globals">register_globals, + you need to instead use the + $_SESSION array + as $_SESSION entries are automatically registered. If your script uses session_register, it will not work in - environments where register_globals + environments where the PHP directive + register_globals is disabled. + +¬e.registerglobals; + This registers a global variable. If you @@ -71,13 +75,17 @@ @@ -102,8 +110,9 @@ - See also session_is_registered and - session_unregister. + See also session_is_registered, + session_unregister, and + $_SESSION. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/session/functions session-start.xml
philip Wed Jun 11 00:03:58 2003 EDT Modified files: /phpdoc/en/reference/session/functions session-start.xml Log: Added an example that shows sessions must be started on every page, not just the first. Note about E_NOTICE since 4.3.3 if session started when session already exists. Link to various session resources including see also's, moved session_name note more towards the bottom, and one grammar fix. Index: phpdoc/en/reference/session/functions/session-start.xml diff -u phpdoc/en/reference/session/functions/session-start.xml:1.4 phpdoc/en/reference/session/functions/session-start.xml:1.5 --- phpdoc/en/reference/session/functions/session-start.xml:1.4 Wed Jan 22 13:34:59 2003 +++ phpdoc/en/reference/session/functions/session-start.xml Wed Jun 11 00:03:58 2003 @@ -1,5 +1,5 @@ - + @@ -18,20 +18,77 @@ passed via a request, such as GET, POST, or a cookie. - If you want to use a named session, you must call - session_name before calling - session_start. - - This function always returns &true;. If you are using cookie-based sessions, you must call - session_start before anything is output to the + session_start before anything is outputted to the browser. + + + A session example: page1.php + + + + + + + After viewing page1.php, the second page + page2.php will magically contain the session + data. Read the session reference + for information on propagating + session ids as it, for example, explains what the constant + SID is all about. + + + + A session example: page2.php + + + + + + + If you want to use a named session, you must call + session_name before calling + session_start. + session_start will register internal output handler for URL rewriting when trans-sid is @@ -46,6 +103,20 @@ is recommended rather than ob_gzhandler + + + As of PHP 4.3.3, calling session_start while the + session has already been started will result in an error of level + E_NOTICE. Also, the second session start will + simply be ignored. + + + + See also + $_SESSION, + session.auto_start, and + session_id. + -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] Re: [DOC-DE] Re: License for documentation
Apart from the book Hakan mentioned, there were some discussed in the thread: http://marc.theaimsgroup.com/?t=9829681195&r=1&w=2 The one Hakan referred to is at: http://marc.theaimsgroup.com/?l=phpdoc&m=96689232820079&w=2 HTH --- Hakan Kuecuekyilmaz <[EMAIL PROTECTED]> wrote: > Friedhelm Betz wrote: > > >On Tuesday 10 June 2003 11:21, Jesus M. Castagnetto > wrote: > > > > > >>Didn't we have the same problem before, also with > a > >>book in German IIRC? Although in that case the > author > >>did not even ask for permission (I think). > >> > >> > > > >No clue, nor do I remember. > > > I can remember one issue with the PHP Book from > Joerg Krause, he copied > alot and Egon was upset about it. Krause did even > copy 'marlise', the mysql > dummy user. But I dont know when this happend. > > Some time ago when I was writing a german tutorial, > I asked this list > too for > permission to copy some parts of the manual into my > tutorial. > > regards > > > > > > > > >>Might be good to revisit what was dicussed then > >>looking at the mailing list archives. > >> > >> > > > >Could you give me a pointer which year/subject/? > >Maybe you remember? > >Then I can look up the archives and search > >for the discussion. > > > >Friedhelm > > > > > -- > Hakan Kuecuekyilmaz, University of Applied Sciences > Esslingen, Germany > > > > > -- > PHP Documentation Mailing List (http://www.php.net/) > To unsubscribe, visit: http://www.php.net/unsub.php > = --- Jesus M. Castagnetto <[EMAIL PROTECTED]> __ Do you Yahoo!? Yahoo! Calendar - Free online calendar with sync to Outlook(TM). http://calendar.yahoo.com -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Re: [DOC-DE] Re: License for documentation
Friedhelm Betz wrote: On Tuesday 10 June 2003 11:21, Jesus M. Castagnetto wrote: Didn't we have the same problem before, also with a book in German IIRC? Although in that case the author did not even ask for permission (I think). No clue, nor do I remember. I can remember one issue with the PHP Book from Joerg Krause, he copied alot and Egon was upset about it. Krause did even copy 'marlise', the mysql dummy user. But I dont know when this happend. Some time ago when I was writing a german tutorial, I asked this list too for permission to copy some parts of the manual into my tutorial. regards Might be good to revisit what was dicussed then looking at the mailing list archives. Could you give me a pointer which year/subject/? Maybe you remember? Then I can look up the archives and search for the discussion. Friedhelm -- Hakan Kuecuekyilmaz, University of Applied Sciences Esslingen, Germany -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] [DOC-DE] Re: License for documentation
On Tuesday 10 June 2003 11:21, Jesus M. Castagnetto wrote: > Didn't we have the same problem before, also with a > book in German IIRC? Although in that case the author > did not even ask for permission (I think). No clue, nor do I remember. > Might be good to revisit what was dicussed then > looking at the mailing list archives. Could you give me a pointer which year/subject/? Maybe you remember? Then I can look up the archives and search for the discussion. Friedhelm -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/mysqli/functions mysqli-fetch-object.xml mysqli-num-rows.xml mysqli-use-result.xml mysqli-warning-count.xml
didou Tue Jun 10 13:18:06 2003 EDT Modified files: /phpdoc/en/reference/mysqli/functions mysqli-fetch-object.xml mysqli-num-rows.xml mysqli-use-result.xml mysqli-warning-count.xml Log: more documentation, typos, see also and proto fix Index: phpdoc/en/reference/mysqli/functions/mysqli-fetch-object.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-fetch-object.xml:1.4 phpdoc/en/reference/mysqli/functions/mysqli-fetch-object.xml:1.5 --- phpdoc/en/reference/mysqli/functions/mysqli-fetch-object.xml:1.4Sun May 25 15:09:28 2003 +++ phpdoc/en/reference/mysqli/functions/mysqli-fetch-object.xmlTue Jun 10 13:18:06 2003 @@ -1,5 +1,5 @@ - + mysqli_fetch_object @@ -8,12 +8,12 @@ Description - arraymysqli_fetch_object + objectmysqli_fetch_object resourceresult The mysqli_fetch_object will return the current row result set - as an object where the attributes of the object rerpesent the names of the fields found + as an object where the attributes of the object represent the names of the fields found within the result set. If no more rows exist in the current result set, &false; is returned. Index: phpdoc/en/reference/mysqli/functions/mysqli-num-rows.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-num-rows.xml:1.2 phpdoc/en/reference/mysqli/functions/mysqli-num-rows.xml:1.3 --- phpdoc/en/reference/mysqli/functions/mysqli-num-rows.xml:1.2Sat May 24 02:44:21 2003 +++ phpdoc/en/reference/mysqli/functions/mysqli-num-rows.xmlTue Jun 10 13:18:06 2003 @@ -1,10 +1,10 @@ - + mysqli_num_rows - Get the number of rows in a result + Gets the number of rows in a result Index: phpdoc/en/reference/mysqli/functions/mysqli-use-result.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-use-result.xml:1.4 phpdoc/en/reference/mysqli/functions/mysqli-use-result.xml:1.5 --- phpdoc/en/reference/mysqli/functions/mysqli-use-result.xml:1.4 Sun May 25 15:09:28 2003 +++ phpdoc/en/reference/mysqli/functions/mysqli-use-result.xml Tue Jun 10 13:18:06 2003 @@ -1,5 +1,5 @@ - + mysqli_use_result @@ -29,6 +29,11 @@ stored using mysqli_store_result + + See also + mysqli_real_query and + mysqli_store_result. + Index: phpdoc/en/reference/mysqli/functions/mysqli-warning-count.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-warning-count.xml:1.2 phpdoc/en/reference/mysqli/functions/mysqli-warning-count.xml:1.3 --- phpdoc/en/reference/mysqli/functions/mysqli-warning-count.xml:1.2 Sat May 24 02:44:21 2003 +++ phpdoc/en/reference/mysqli/functions/mysqli-warning-count.xml Tue Jun 10 13:18:06 2003 @@ -1,10 +1,10 @@ - + mysqli_warning_count - Return the number of warnings from the last query for the given link + Returns the number of warnings from the last query for the given link @@ -13,9 +13,11 @@ resourcemysqli_warning_count resourcelink - -&warn.undocumented.func; - + + mysqli_warning_count returns the number of warnings + from the last query in the connection represented by the + link parameter. + -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc / TODO
philip Tue Jun 10 12:56:43 2003 EDT Modified files: /phpdoc TODO Log: Add ability for error level linking, example: E_NOTICE -> E_NOTICE Index: phpdoc/TODO diff -u phpdoc/TODO:1.45 phpdoc/TODO:1.46 --- phpdoc/TODO:1.45Tue Jun 10 04:13:30 2003 +++ phpdoc/TODO Tue Jun 10 12:56:43 2003 @@ -72,6 +72,8 @@ - generate a list of all install configure options - generate a list of all examples - generate a list of all requirements from all resources.xml + - generate error level links from +i.e. E_NOTICE -> E_NOTICE GENERAL: - Document php://stdout etc feature for file functions. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/errorfunc constants.xml
philip Tue Jun 10 12:53:37 2003 EDT Modified files: /phpdoc/en/reference/errorfunc constants.xml Log: Implement error level ids, example: E_NOTICE. Index: phpdoc/en/reference/errorfunc/constants.xml diff -u phpdoc/en/reference/errorfunc/constants.xml:1.7 phpdoc/en/reference/errorfunc/constants.xml:1.8 --- phpdoc/en/reference/errorfunc/constants.xml:1.7 Wed May 21 06:34:22 2003 +++ phpdoc/en/reference/errorfunc/constants.xml Tue Jun 10 12:53:37 2003 @@ -1,5 +1,5 @@ - + &reftitle.constants; &extension.constants.core; @@ -10,7 +10,7 @@ use the bitmask values instead. - + Errors and Logging @@ -22,7 +22,7 @@ - + 1 E_ERROR @@ -36,7 +36,7 @@ - + 2 E_WARNING @@ -49,7 +49,7 @@ - + 4 E_PARSE @@ -62,7 +62,7 @@ - + 8 E_NOTICE @@ -76,7 +76,7 @@ - + 16 E_CORE_ERROR @@ -89,7 +89,7 @@ PHP 4 only - + 32 E_CORE_WARNING @@ -103,7 +103,7 @@ PHP 4 only - + 64 E_COMPILE_ERROR @@ -116,7 +116,7 @@ PHP 4 only - + 128 E_COMPILE_WARNING @@ -130,7 +130,7 @@ PHP 4 only - + 256 E_USER_ERROR @@ -144,7 +144,7 @@ PHP 4 only - + 512 E_USER_WARNING @@ -158,7 +158,7 @@ PHP 4 only - + 1024 E_USER_NOTICE @@ -172,7 +172,7 @@ PHP 4 only - + 2047 E_ALL -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] cvs: phpdoc /en/reference/sesam/functionssesam-field-array.xml
Plus we don't support PHP 3 anymore.. :) --Jani On Tue, 10 Jun 2003, Philip Olson wrote: >On Tue, 10 Jun 2003, Jani Taskinen wrote: > >> >> Heh, what is this..? Some remainders from php3 or what? :) >> This really doesn't exist in PHP anymore, why is it >> documented still? :) > >So the PHP 3 users out there can still use it! :) Hopefully >the phpdoc meeting concludes some good ideas on dealing with >deprecated extensions but this one is unique in that it never >even worked in PHP 4. History is such a wonderful thing, it >would break my heart to even delete this from existence but >maybe it's for the best. This isn't even PECL material. > >Regards, >Philip > -- https://www.paypal.com/xclick/[EMAIL PROTECTED]&no_note=1&tax=0¤cy_code=EUR -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] cvs: phpdoc /en/reference/sesam/functionssesam-field-array.xml
On Tue, 10 Jun 2003, Jani Taskinen wrote: > > Heh, what is this..? Some remainders from php3 or what? :) > This really doesn't exist in PHP anymore, why is it > documented still? :) So the PHP 3 users out there can still use it! :) Hopefully the phpdoc meeting concludes some good ideas on dealing with deprecated extensions but this one is unique in that it never even worked in PHP 4. History is such a wonderful thing, it would break my heart to even delete this from existence but maybe it's for the best. This isn't even PECL material. Regards, Philip -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] cvs: phpdoc /en/reference/sesam/functionssesam-field-array.xml
Heh, what is this..? Some remainders from php3 or what? :) This really doesn't exist in PHP anymore, why is it documented still? :) --Jani On Mon, 9 Jun 2003, Damien Seguy wrote: >dams Mon Jun 9 15:09:43 2003 EDT > > Modified files: >/phpdoc/en/reference/sesam/functions sesam-field-array.xml > Log: > removed extra word > >Index: phpdoc/en/reference/sesam/functions/sesam-field-array.xml >diff -u phpdoc/en/reference/sesam/functions/sesam-field-array.xml:1.2 >phpdoc/en/reference/sesam/functions/sesam-field-array.xml:1.3 >--- phpdoc/en/reference/sesam/functions/sesam-field-array.xml:1.2 Wed Apr 17 >02:43:54 2002 >+++ phpdoc/en/reference/sesam/functions/sesam-field-array.xml Mon Jun 9 15:09:42 >2003 >@@ -1,5 +1,5 @@ > >- >+ > > > >@@ -186,7 +186,7 @@ > > > >- See the sesam_query function for an example >+ See also sesam_query for an example > of the sesam_field_array use. > > > > > > -- https://www.paypal.com/xclick/[EMAIL PROTECTED]&no_note=1&tax=0¤cy_code=EUR -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] Re: [DOC-DE] Re: License for documentation
Didn't we have the same problem before, also with a book in German IIRC? Although in that case the author did not even ask for permission (I think). Might be good to revisit what was dicussed then looking at the mailing list archives. --- Friedhelm Betz <[EMAIL PROTECTED]> wrote: > On Thursday 05 June 2003 20:02, Gabor Hojtsy wrote: > > Given that Andreas was unable to post his message > following this thread, > > and instead he opened several new threads, which > we would be unable to > > join, I am doing what I have asked him to do: "use > reply all". > > > > Here is the message he tried to send to us: > > | I've written a very practical PHP book, that > introduces that great > > | script language, PHP. That part of the book I've > writte is about 250 > > | Pages and that part of the book containing the > reference (funktion > > | List) is about 200 Pages. But I wouldn't like to > publish the whole > > | function list. That what I would like to publish > is : the reference > > | of: > > | 1. Array Functions > > | 2. Date Functions > > | 3. Filefunctions I/O Functions > > | 4. Math Functions > > | 5. MySQL Functions > > | 6. Stringfunctions > > | 7. Var. Functions > > | 8. Session Handling > > | 9. Grafik Functions GD Modul > > | 10. Reg Ex > > | 11 Errorhandling > > | 12 Functionhandling > > | > > | And I only would like to publish the German > version not the English > > | Version !!! > > | Could I do that ? > > > > My question on what he would like to repusblish is > only implicitly > > answered, he said nothing about the content he > would like to republish, > > but as it seems to me half of the book would be > from the German PHP > > manual (200 pages), so it won't be just a list, as > he suggested but a > > full documentation. > > > > Now the question is what the English authors and > the German translators > > think about a book containing part of the manual > as one half of the > > content of it. > > As one of the German translators (don't know about > other people opinions): > First of all: the German trans might be particular > outdated and therefore > plain misleading/wrong. Publishing in a printed book > seems not a good idea to > me, pointing to the online docs (and the > downloadable versions) is always > possible. > Near 50 % of a book is a huge amount, and I > personally have some objections > against. I might be wrong, but Andreas never > contributed to the German trans > and selling half a book based on the work of others > is not smart;-) > So I am -1 on this. > Anyway, contributing to the German trans is always > welcome. > > Friedhelm > > > > > -- > PHP Documentation Mailing List (http://www.php.net/) > To unsubscribe, visit: http://www.php.net/unsub.php > = --- Jesus M. Castagnetto <[EMAIL PROTECTED]> __ Do you Yahoo!? The New Yahoo! Search - Faster. Easier. Bingo http://search.yahoo.com -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc / TODO
betzTue Jun 10 04:13:31 2003 EDT Modified files: /phpdoc TODO Log: License is changed to OPL in agreement with the authors Index: phpdoc/TODO diff -u phpdoc/TODO:1.44 phpdoc/TODO:1.45 --- phpdoc/TODO:1.44Mon Feb 10 08:16:30 2003 +++ phpdoc/TODO Tue Jun 10 04:13:30 2003 @@ -7,8 +7,6 @@ DISCUSSIONS: - coding standards for scripts in phpdoc (see the howto and phpdoc/RFC/coding_standards) - - licensing issues, possible licenses: see phpdoc/RFC/license for the -summary of Hartmut - users manual / developers manual division? effects on folders, files, make system, style sheets - see: RFC/manual_splitting -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] Re: [DOC-DE] Re: License for documentation
On Thursday 05 June 2003 20:02, Gabor Hojtsy wrote: > Given that Andreas was unable to post his message following this thread, > and instead he opened several new threads, which we would be unable to > join, I am doing what I have asked him to do: "use reply all". > > Here is the message he tried to send to us: > | I've written a very practical PHP book, that introduces that great > | script language, PHP. That part of the book I've writte is about 250 > | Pages and that part of the book containing the reference (funktion > | List) is about 200 Pages. But I wouldn't like to publish the whole > | function list. That what I would like to publish is : the reference > | of: > | 1. Array Functions > | 2. Date Functions > | 3. Filefunctions I/O Functions > | 4. Math Functions > | 5. MySQL Functions > | 6. Stringfunctions > | 7. Var. Functions > | 8. Session Handling > | 9. Grafik Functions GD Modul > | 10. Reg Ex > | 11 Errorhandling > | 12 Functionhandling > | > | And I only would like to publish the German version not the English > | Version !!! > | Could I do that ? > > My question on what he would like to repusblish is only implicitly > answered, he said nothing about the content he would like to republish, > but as it seems to me half of the book would be from the German PHP > manual (200 pages), so it won't be just a list, as he suggested but a > full documentation. > > Now the question is what the English authors and the German translators > think about a book containing part of the manual as one half of the > content of it. As one of the German translators (don't know about other people opinions): First of all: the German trans might be particular outdated and therefore plain misleading/wrong. Publishing in a printed book seems not a good idea to me, pointing to the online docs (and the downloadable versions) is always possible. Near 50 % of a book is a huge amount, and I personally have some objections against. I might be wrong, but Andreas never contributed to the German trans and selling half a book based on the work of others is not smart;-) So I am -1 on this. Anyway, contributing to the German trans is always welcome. Friedhelm -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /RFC LICENSE
betzTue Jun 10 03:48:58 2003 EDT Removed files: /phpdoc/RFC LICENSE Log: Lives now in /phpdoc -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc / LICENSE
betzTue Jun 10 03:46:49 2003 EDT Modified files: /phpdoc LICENSE Log: OPL License added Index: phpdoc/LICENSE diff -u /dev/null phpdoc/LICENSE:1.3 --- /dev/null Tue Jun 10 03:46:48 2003 +++ phpdoc/LICENSE Tue Jun 10 03:46:48 2003 @@ -0,0 +1,23 @@ +Copyright (c) 1997 - 2003 by the PHP Documentation Group. +This material may be distributed only subject to the terms and +conditions set forth in the Open Publication License, v1.0 or +later (the latest version is presently available at +http://www.opencontent.org/openpub/). + +Distribution of substantively modified versions of this document +is prohibited without the explicit permission of the copyright +holder. + +Distribution of the work or derivative of the work in any +standard (paper) book form is prohibited unless prior permission +is obtained from the copyright holder. + +The members of the PHP Documentation Group are listed at +http://www.php.net/manual/en/. In case you would like to contact the group, +please write to [EMAIL PROTECTED] + +The 'Extending PHP 4.0' section of this manual is copyright (c) 2000 by +Zend Technologies, Ltd. This material may be distributed only subject to +the terms and conditions set forth in the Open Publication License, v1.0 +or later (the latest version is presently available at +http://www.opencontent.org/openpub/). -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] cvs: phpdoc / LICENSE
betz Tue Jun 10 03:43:48 2003 EDT Removed files: /phpdoc LICENSE Log: GPL License file removed As no comment arrived from others, I think the license in RFC can be moved here. The authors agreed on that license, and no opposition was present on this particular reference of the license. Goba -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc / LICENSE
betzTue Jun 10 03:43:48 2003 EDT Removed files: /phpdoc LICENSE Log: GPL License file removed -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] cvs: phpdoc /en/reference/misc/functions eval.xml
return is how it's done, just like include, print, etc. Have a look at php.net/eval and notice it links to the return docs. In conclusion: this should be reverted ;) Ths simple proof is that /manual/en/function.return.php is the doc page for return. return links to that. Goba -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] #23195 [Opn]: copying an array resets its pointer
ID: 23195
Updated by: [EMAIL PROTECTED]
Reported By: jc at mega-bucks dot co dot jp
Status: Open
Bug Type: Documentation problem
Operating System: Red Hat Linux 8.0
PHP Version: 4.3.2RC1
-Assigned To:
+Assigned To: philip
New Comment:
pong
Previous Comments:
[2003-06-10 02:05:00] jc at mega-bucks dot co dot jp
Fine, it's a lack of documentation about some weird PHP behaviour :)
(yes it *is* weird)
Somebody please fix it. This bug keeps geeting closed and reopened and
passed around. End the torment ^_~
[2003-06-10 01:58:52] [EMAIL PROTECTED]
This isn't a bug in anything but docs..
[2003-06-10 00:53:04] [EMAIL PROTECTED]
This makes no sense to me, why would assigning an array to another
variable affect the original arrays pointer? Even the array it's
assigned to keeps the original pointer:
Either $array should also keep its pointer or $array2 should also have
a reset pointer. I'd assume both would keep the current pointer, or
maybe just $array2 would have a reset pointer :). Current behavior is
certainly not documented, and are you guys sure this isn't a bug?
[2003-04-25 00:10:48] jc at mega-bucks dot co dot jp
Thanks for looking into this, but I cannot find anywhere in the
documenation that states that assigning an array to a variable resets
the array's pointer to the first element. Can you point me to such
documentation?
Furthermore if you are right, and I'm sure you are, then some of the
documentation is wrong or confusing at best. Consider the following
from the docs:
http://www.php.net/manual/en/control-structures.foreach.php
The following are also functionally identical:
reset ($arr);
while (list($key, $value) = each ($arr)) {
echo "Key: $key; Value: $value\n";
}
foreach ($arr as $key => $value) {
echo "Key: $key; Value: $value\n";
}
But has you said, those are *not* functionally identical.
Or from http://www.php.net/manual/en/function.each.php
each() is typically used in conjunction with list() to traverse an
array; for instance, $_POST:
Example 2. Traversing $_POST with each()
echo "Values submitted via POST method:\n";
reset ($_POST);
while (list ($key, $val) = each ($_POST)) {
echo "$key => $val\n";
}
Reading the documentation on each() and on arrays the above two
examples teach that using a while(list() = each()) is a correct way of
traversing an array. Which it obviously is *not* if you plan on
assigning the array you are traversing to a variable ...
Either the each() function should be removed to force the use of the
assignment-safe 'foreach()' or the documentation should mention that
when assigning an array to a variable the current element-pointer is
reset.
[2003-04-24 19:49:05] [EMAIL PROTECTED]
Thank you for taking the time to write to us, but this is not
a bug. Please double-check the documentation available at
http://www.php.net/manual/ and the instructions on how to report
a bug at http://bugs.php.net/how-to-report.php
When you assign the array to another variable the internal array
position pointer gets reset. Which causes you loop which depends on the
array position to loop indefinately.
Use foreach() or a for() loop.
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/23195
--
Edit this bug report at http://bugs.php.net/?id=23195&edit=1
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] #23195 [Opn]: copying an array resets its pointer
ID: 23195
User updated by: jc at mega-bucks dot co dot jp
Reported By: jc at mega-bucks dot co dot jp
Status: Open
Bug Type: Documentation problem
Operating System: Red Hat Linux 8.0
PHP Version: 4.3.2RC1
New Comment:
Fine, it's a lack of documentation about some weird PHP behaviour :)
(yes it *is* weird)
Somebody please fix it. This bug keeps geeting closed and reopened and
passed around. End the torment ^_~
Previous Comments:
[2003-06-10 01:58:52] [EMAIL PROTECTED]
This isn't a bug in anything but docs..
[2003-06-10 00:53:04] [EMAIL PROTECTED]
This makes no sense to me, why would assigning an array to another
variable affect the original arrays pointer? Even the array it's
assigned to keeps the original pointer:
Either $array should also keep its pointer or $array2 should also have
a reset pointer. I'd assume both would keep the current pointer, or
maybe just $array2 would have a reset pointer :). Current behavior is
certainly not documented, and are you guys sure this isn't a bug?
[2003-04-25 00:10:48] jc at mega-bucks dot co dot jp
Thanks for looking into this, but I cannot find anywhere in the
documenation that states that assigning an array to a variable resets
the array's pointer to the first element. Can you point me to such
documentation?
Furthermore if you are right, and I'm sure you are, then some of the
documentation is wrong or confusing at best. Consider the following
from the docs:
http://www.php.net/manual/en/control-structures.foreach.php
The following are also functionally identical:
reset ($arr);
while (list($key, $value) = each ($arr)) {
echo "Key: $key; Value: $value\n";
}
foreach ($arr as $key => $value) {
echo "Key: $key; Value: $value\n";
}
But has you said, those are *not* functionally identical.
Or from http://www.php.net/manual/en/function.each.php
each() is typically used in conjunction with list() to traverse an
array; for instance, $_POST:
Example 2. Traversing $_POST with each()
echo "Values submitted via POST method:\n";
reset ($_POST);
while (list ($key, $val) = each ($_POST)) {
echo "$key => $val\n";
}
Reading the documentation on each() and on arrays the above two
examples teach that using a while(list() = each()) is a correct way of
traversing an array. Which it obviously is *not* if you plan on
assigning the array you are traversing to a variable ...
Either the each() function should be removed to force the use of the
assignment-safe 'foreach()' or the documentation should mention that
when assigning an array to a variable the current element-pointer is
reset.
[2003-04-24 19:49:05] [EMAIL PROTECTED]
Thank you for taking the time to write to us, but this is not
a bug. Please double-check the documentation available at
http://www.php.net/manual/ and the instructions on how to report
a bug at http://bugs.php.net/how-to-report.php
When you assign the array to another variable the internal array
position pointer gets reset. Which causes you loop which depends on the
array position to loop indefinately.
Use foreach() or a for() loop.
[2003-04-18 21:19:43] [EMAIL PROTECTED]
Here is a shorter example that demonstrates the problem:
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/23195
--
Edit this bug report at http://bugs.php.net/?id=23195&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/array reference.xml
betzTue Jun 10 03:02:20 2003 EDT Modified files: /phpdoc/en/reference/array reference.xml Log: join is an alias of implode Index: phpdoc/en/reference/array/reference.xml diff -u phpdoc/en/reference/array/reference.xml:1.9 phpdoc/en/reference/array/reference.xml:1.10 --- phpdoc/en/reference/array/reference.xml:1.9 Thu Jun 5 05:30:00 2003 +++ phpdoc/en/reference/array/reference.xml Tue Jun 10 03:02:20 2003 @@ -1,5 +1,5 @@ - + Array Functions Arrays @@ -52,8 +52,7 @@ See also is_array, explode, implode, split, - preg_split, join, - and unset. + preg_split, and unset. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
