[PHP-DOC] cvs: phpdoc /en/reference/url/functions base64-decode.xml base64-encode.xml rawurlencode.xml

2002-07-30 Thread Friedhelm Betz

betzTue Jul 30 05:25:35 2002 EDT

  Modified files:  
/phpdoc/en/reference/url/functions  rawurlencode.xml 
base64-encode.xml 
base64-decode.xml 
  Log:
  make RFC's as link
  
  
Index: phpdoc/en/reference/url/functions/rawurlencode.xml
diff -u phpdoc/en/reference/url/functions/rawurlencode.xml:1.2 
phpdoc/en/reference/url/functions/rawurlencode.xml:1.3
--- phpdoc/en/reference/url/functions/rawurlencode.xml:1.2  Wed Apr 17 02:44:55 
2002
+++ phpdoc/en/reference/url/functions/rawurlencode.xml  Tue Jul 30 05:25:35 2002
 -1,10 +1,10 
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.2 $ --
+!-- $Revision: 1.3 $ --
 !-- splitted from ./en/functions/url.xml, last change in rev 1.6 --
   refentry id=function.rawurlencode
refnamediv
 refnamerawurlencode/refname
-refpurposeURL-encode according to RFC1738/refpurpose
+refpurposeURL-encode according to RFC 1738/refpurpose
/refnamediv
refsect1
 titleDescription/title
 -16,10 +16,10 
  Returns a string in which all non-alphanumeric characters except
  screen-_./screen have been replaced with a percent
  (literal%/literal) sign followed by two hex digits.  This is
- the encoding described in RFC1738 for protecting literal
+ the encoding described in RFC 1738 for protecting literal
  characters from being interpreted as special URL delimiters, and
  for protecting URL's from being mangled by transmission media
- with character conversions (like some email systems).  For
+ with character conversions (like some email systems). For
  example, if you want to include a password in an FTP URL:
 /para
 example
 -46,7 +46,8 
 simpara
  See also functionrawurldecode/function,
  functionurldecode/function,
- functionurlencode/function.
+ functionurlencode/function and
+ ulink url=url.rfc;rfc1738.htmlRFC 1738/ulink
 /simpara
/refsect1
   /refentry
Index: phpdoc/en/reference/url/functions/base64-encode.xml
diff -u phpdoc/en/reference/url/functions/base64-encode.xml:1.2 
phpdoc/en/reference/url/functions/base64-encode.xml:1.3
--- phpdoc/en/reference/url/functions/base64-encode.xml:1.2 Wed Apr 17 02:44:54 
2002
+++ phpdoc/en/reference/url/functions/base64-encode.xml Tue Jul 30 05:25:35 2002
 -1,5 +1,5 
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.2 $ --
+!-- $Revision: 1.3 $ --
 !-- splitted from ./en/functions/url.xml, last change in rev 1.2 --
   refentry id=function.base64-encode
refnamediv
 -25,7 +25,7 
  See also:
  functionbase64_decode/function,
  functionchunk_split/function,
- RFC2045 section 6.8.
+ ulink url=url.rfc;rfc2045.htmlRFC 2045/ulink section 6.8.
 /para
/refsect1
   /refentry
Index: phpdoc/en/reference/url/functions/base64-decode.xml
diff -u phpdoc/en/reference/url/functions/base64-decode.xml:1.2 
phpdoc/en/reference/url/functions/base64-decode.xml:1.3
--- phpdoc/en/reference/url/functions/base64-decode.xml:1.2 Wed Apr 17 02:44:54 
2002
+++ phpdoc/en/reference/url/functions/base64-decode.xml Tue Jul 30 05:25:35 2002
 -1,5 +1,5 
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.2 $ --
+!-- $Revision: 1.3 $ --
 !-- splitted from ./en/functions/url.xml, last change in rev 1.2 --
   refentry id=function.base64-decode
refnamediv
 -15,11 +15,11 
 para
  functionbase64_decode/function decodes
  parameterencoded_data/parameter and returns the original
- data.  The returned data may be binary.
+ data. The returned data may be binary.
 /para
 para
- See also: functionbase64_encode/function, RFC2045 section
- 6.8.
+ See also: functionbase64_encode/function,
+ ulink url=url.rfc;rfc2045.htmlRFC 2045/ulink section 6.8.
 /para
/refsect1
   /refentry



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] #17556 [Com]: Docs lack specific info about switch() and continue;

2002-07-30 Thread ahristov

 ID:   17556
 Comment by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
 Status:   Bogus
 Bug Type: Documentation problem
 Operating System: All
 PHP Version:  4.2.1
 New Comment:

Here are two examples:
?php

$counter = 0;
while ($counter20){
switch ($counter){
case 0:
case 1:
case 2:
case 3:
case 4:
case 5:
case 6:
case 7:
case 8:
case 9:
$counter++;
break;
default:
$counter+=2;
continue;

}// swhitch
echo 'FUBAR'.[$counter]\n;
}//while

?
?php
$counter = 0;
while ($counter20){
switch ($counter){
case 0:
case 1:
case 2:
case 3:
case 4:
case 5:
case 6:
case 7:
case 8:
case 9:
$counter++;
break;
default:
$counter+=2;
continue(2);
}// switch
echo 'FUBAR'.[$counter]\n;
}// while
?
The intention is to show that there is no note in the docs for that
when programmer wants to go to the next iteration of the loop that is
shell to the switch() he/she must use continue(2); not continue;. This
is because in switch()-es continue; is equivalent to break;
In general if programmer want to skip the rest of the n-th loop
(counted from the most inner to most outter) he must use continue(n+1);
and not contunie(n);

If there is something hard to get (beacuse of my english) please
contact me and I will explain.
Regards,
Andrey Hristov


Previous Comments:


[2002-07-29 16:47:36] [EMAIL PROTECTED]

With respect to what you wanted to say, your second example is not
what you explained in your original report. Be more careful with your
wording or include an example that clarifies your report. If you
re-read your first report there is *no mention at all* of the case
where switch is inside a loop (while, for, etc.)





Also, your logic does not seem too clear to me in your example. What is
the *exact* intended effect?, perhaps that the continue goes to the
top of the while loop  even though it is *not* in the current scope of
that block but in the switch block, that will be an odd behaviour
indeed. 





If you can be:





(a) more precise w/ respect to the execution flow, 





(b) provide some examples of other scripting languages where the switch
supports a continue that behaves like you are mentioning here, 





(c) explain why such a construct is desirable instead of the more logic
one of doing a break in the switch block and perfoming the conditional
comparison outside the switch block, so you are not dependent on
side-effects (which can be tricky to debug later on)





Then there will be a good change to reopening this bug. Will wait for
your feedback, but will not reclassify this out of Bogus for the time
being.






[2002-07-29 10:11:54] [EMAIL PROTECTED]

I think that Mr Jesus Catagnetto misunsterstood what I am talking
about. IMO the bug must be reopened.

I just wanted to say that
while (some){
 switch ($foo){
   case 'bar':
if (some_reason) continue;//ie next iteration, but no, it will
increment counter after the switch. Must be continue(2);
   break;
   case 'boo':
//
   break;
   default:
   break;
 }
echo $counter++;
}



[2002-06-01 17:02:20] [EMAIL PROTECTED]

Ehem, the documentation for switch explicitly says:

... The switch statement is similar to a series of IF statements on
the same expression ...

And I do not know of any language that uses a series of if statements
as a loop construct (that is why for, while and do ... while are
there). If you know of one, I will be interesting to check it out to
see how that can be done.

Also, nowhere there is mentioned that continue can be used to loop in
a non-looping construct (e.g. if), and if you read again the the
description of continue it says:

continue is used within looping structures to skip the rest of the
current loop iteration and continue executio at the beginning of the
next iteration

thus if you use that in a context where there is no loop, it just gets
out of scope.

This is (or should) something learned in basics of programming book,
article, etc.




[2002-06-01 15:12:51] [EMAIL PROTECTED]

 After 2 years of coding in PHP I 

[PHP-DOC] #18629 [Bgs]: Undocumented behavior of arrays

2002-07-30 Thread rasmus

 ID:   18629
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
 Status:   Bogus
 Bug Type: Documentation problem
 Operating System: Linux
 PHP Version:  4.2.2
 New Comment:

Well, actually, PHP arrays are always ordered arrays.  They are hashes
in the sense that the index can be anything.  Perhaps a better
description is that they are ordered associative arrays.  So yes, you
can rely on the order remaining constant and this will not change.


Previous Comments:


[2002-07-29 16:55:40] [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

Arrays in PHP are the equivalent to hashes in other languages, so the
order of the elements is not assured. The foreach construct will
retrieved the data from the hash similarly, so in the general case you
should not rely on the order being the original order.

Not sure it should be documented that for PHP compiled on under some
OSes and compiler combinations results in the element order being kept.
After all the reason for using associative arrays is to be able to
access elements by \name\.



[2002-07-29 14:50:38] [EMAIL PROTECTED]

If you iterate an associative array with foreach(),  it seems like it
plays elements back in the order in which they were added. This
behavior is useful,  but seems to be undocumented.  I'd like to see
this documented,  because otherwise I'm afraid this behavior will
change in future versions of PHP.




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


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] #18649 [NEW]: Documentation for array_diff incomplete

2002-07-30 Thread nohn

From: [EMAIL PROTECTED]
Operating system: All
PHP version:  4CVS-2002-07-30
PHP Bug Type: Documentation problem
Bug description:  Documentation for array_diff incomplete

It should be mentioned that array_diff only checks one dimension of an
n-dimensional array.

for example:

Array
(
   [0] = Array
   (
[0] = test
[1] = lala
   )
)

is the same like 

Array
(
   [0] = Array
   (
[0] = test
[1] = bubu
   )
)

when checking Array with array_diff.

Only when checking Array[0] with array_diff it returns that the arrays
differ


-- 
Edit bug report at http://bugs.php.net/?id=18649edit=1
-- 
Fixed in CVS:http://bugs.php.net/fix.php?id=18649r=fixedcvs
Fixed in release:http://bugs.php.net/fix.php?id=18649r=alreadyfixed
Need backtrace:  http://bugs.php.net/fix.php?id=18649r=needtrace
Try newer version:   http://bugs.php.net/fix.php?id=18649r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=18649r=support
Expected behavior:   http://bugs.php.net/fix.php?id=18649r=notwrong
Not enough info: http://bugs.php.net/fix.php?id=18649r=notenoughinfo
Submitted twice: http://bugs.php.net/fix.php?id=18649r=submittedtwice
register_globals:http://bugs.php.net/fix.php?id=18649r=globals


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] cvs: phpdoc /en/reference/imap/functions imap-get-quota.xml

2002-07-30 Thread Friedhelm Betz

betzTue Jul 30 11:41:47 2002 EDT

  Modified files:  
/phpdoc/en/reference/imap/functions imap-get-quota.xml 
  Log:
  build errors corrected;
  remember to make test :-)
  
  
Index: phpdoc/en/reference/imap/functions/imap-get-quota.xml
diff -u phpdoc/en/reference/imap/functions/imap-get-quota.xml:1.3 
phpdoc/en/reference/imap/functions/imap-get-quota.xml:1.4
--- phpdoc/en/reference/imap/functions/imap-get-quota.xml:1.3   Mon Jul 29 14:06:17 
2002
+++ phpdoc/en/reference/imap/functions/imap-get-quota.xml   Tue Jul 30 11:41:47 
+2002
 -1,5 +1,5 
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.3 $ --
+!-- $Revision: 1.4 $ --
 !-- splitted from ./en/functions/imap.xml, last change in rev 1.2 --
   refentry id=function.imap-get-quota
refnamediv
 -30,7 +30,6 
  as the mail-admin user.!-- To be uncommented once imap_get_quotaroot is
  working --!-- For a non-admin user version of this function, please see
  the functionimap_get_quotaroot/function function of PHP. --
-para
  parameterimap_stream/parameter should be the value returned from
  an functionimap_open/function call.  NOTE: This stream is required 
  to be opened as the mail admin user for the get_quota function to work.



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] cvs: phpdoc /en/reference/dir/functions chroot.xml

2002-07-30 Thread Friedhelm Betz

betzTue Jul 30 12:14:34 2002 EDT

  Modified files:  
/phpdoc/en/reference/dir/functions  chroot.xml 
  Log:
  not available on windows
  
  
Index: phpdoc/en/reference/dir/functions/chroot.xml
diff -u phpdoc/en/reference/dir/functions/chroot.xml:1.2 
phpdoc/en/reference/dir/functions/chroot.xml:1.3
--- phpdoc/en/reference/dir/functions/chroot.xml:1.2Wed Apr 17 02:37:34 2002
+++ phpdoc/en/reference/dir/functions/chroot.xmlTue Jul 30 12:14:34 2002
 -1,5 +1,5 
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.2 $ --
+!-- $Revision: 1.3 $ --
 !-- splitted from ./en/functions/dir.xml, last change in rev 1.11 --
   refentry id=function.chroot
refnamediv
 -25,6 +25,7 
   will only function correct when running as CGI this way.
  /para
 /note
+note.no-windows;
/refsect1
   /refentry
 



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




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

2002-07-30 Thread Friedhelm Betz

betzTue Jul 30 12:15:47 2002 EDT

  Modified files:  
/phpdoc/en/reference/stringsreference.xml 
  Log:
  new structure applied
  
  
Index: phpdoc/en/reference/strings/reference.xml
diff -u phpdoc/en/reference/strings/reference.xml:1.3 
phpdoc/en/reference/strings/reference.xml:1.4
--- phpdoc/en/reference/strings/reference.xml:1.3   Sat Jun  1 12:33:43 2002
+++ phpdoc/en/reference/strings/reference.xml   Tue Jul 30 12:15:47 2002
 -1,28 +1,51 
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.3 $ --
+!-- $Revision: 1.4 $ --
  reference id=ref.strings
   titleString functions/title
   titleabbrevStrings/titleabbrev
 
   partintro
-   simpara
-These functions all manipulate strings in various ways. Some more
-specialized sections can be found in the regular expression and
-URL handling sections.
-   /simpara
-   para
-For information on how strings behave, especially with regard to
-usage of single quotes, double quotes, and escape sequences, see
-the link linkend=language.types.stringStrings/link entry in
-the link linkend=language.typesTypes/link section of the
-manual. 
-   /para
-   para
-For even more powerful string handling and manipulating functions
-take a look at the link linkend=ref.regexPOSIX regular
-expression functions/link and the link linkend=ref.pcrePerl
-compatible regular expression functions/link.
-   /para
+   section id=strings.intro
+reftitle.intro;
+para
+ These functions all manipulate strings in various ways. Some more
+ specialized sections can be found in the regular expression and
+ link linkend=ref.urlURL handling/link sections.
+/para
+para
+ For information on how strings behave, especially with regard to
+ usage of single quotes, double quotes, and escape sequences, see
+ the link linkend=language.types.stringStrings/link entry in
+ the link linkend=language.typesTypes/link section of the
+ manual.
+/para
+   /section
+
+   section id=strings.requirements
+reftitle.required;
+no.requirement;
+   /section
+
+   section id=strings.installation
+reftitle.install;
+no.install;
+   /section
+   
+   
+   section id=strings.constants
+reftitle.constants;
+no.constants;
+   /section
+
+   section id=strings.seealso
+reftitle.seealso;
+para
+ For even more powerful string handling and manipulating functions
+ take a look at the link linkend=ref.regexPOSIX regular
+ expression functions/link and the link linkend=ref.pcrePerl
+ compatible regular expression functions/link.
+/para
+   /section
   /partintro
 
 reference.strings.functions;



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] cvs: phpdoc /en/reference rsusi.txt

2002-07-30 Thread Friedhelm Betz

betzTue Jul 30 12:16:27 2002 EDT

  Modified files:  
/phpdoc/en/referencersusi.txt 
  Log:
  reflect changes
  
  
Index: phpdoc/en/reference/rsusi.txt
diff -u phpdoc/en/reference/rsusi.txt:1.22 phpdoc/en/reference/rsusi.txt:1.23
--- phpdoc/en/reference/rsusi.txt:1.22  Sun Jul 28 15:58:11 2002
+++ phpdoc/en/reference/rsusi.txt   Tue Jul 30 12:16:27 2002
 -113,7 +113,7 
 shmop  !no
 snmp   !no
 sockets++
-strings!no
+strings
 swf
 sybase !no
 tokenizer  ~



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] cvs: phpdoc /en/reference rsusi.txt

2002-07-30 Thread Friedhelm Betz

betzTue Jul 30 12:50:15 2002 EDT

  Modified files:  
/phpdoc/en/referencersusi.txt 
  Log:
  reflect changes for nis, oracle, pcre and pspell.
  probably forgotten by Goba :-)
  
  
Index: phpdoc/en/reference/rsusi.txt
diff -u phpdoc/en/reference/rsusi.txt:1.23 phpdoc/en/reference/rsusi.txt:1.24
--- phpdoc/en/reference/rsusi.txt:1.23  Tue Jul 30 12:16:27 2002
+++ phpdoc/en/reference/rsusi.txt   Tue Jul 30 12:50:15 2002
 -86,23 +86,23 
 mysql  
 ncurses
 network~
-nis!no
+nis
 notes  !no
 objaggregation 
 oci8   !no
 openssl!no
-oracle !no
+oracle ~
 outcontrol !no
 overload   !no
 ovrimos!no
 pcntl  !no
-pcre   !no
+pcre   
 pdf!no
 pfpro  !no
 pgsql  !no
 posix  !no
 printer!no
-pspell !no
+pspell 
 qtdom  !no
 readline   
 recode !no



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] cvs: phpdoc /en/reference/array/functions array-diff.xml

2002-07-30 Thread Sebastian Nohn

nohnTue Jul 30 17:11:51 2002 EDT

  Modified files:  
/phpdoc/en/reference/array/functionsarray-diff.xml 
  Log:
  Fixing bug #18649
  
  
Index: phpdoc/en/reference/array/functions/array-diff.xml
diff -u phpdoc/en/reference/array/functions/array-diff.xml:1.4 
phpdoc/en/reference/array/functions/array-diff.xml:1.5
--- phpdoc/en/reference/array/functions/array-diff.xml:1.4  Sun May 12 04:19:28 
2002
+++ phpdoc/en/reference/array/functions/array-diff.xml  Tue Jul 30 17:11:51 2002
 -1,5 +1,5 
 ?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.4 $ --
+!-- $Revision: 1.5 $ --
 !-- splitted from ./en/functions/array.xml, last change in rev 1.14 --
   refentry id=function.array-diff
refnamediv
 -43,6 +43,13 
   literal(string) $elem1 === (string) $elem2/literal. In words:
   when the string representation is the same.
   !-- TODO: example of it... --
+ /simpara
+/note
+note
+ simpara
+  Please note that this function only checks one dimension of a n-dimensional
+  array. Of course you can check deeper dimensions by using
+  literalarray_diff($array1[0], $array2[0]);/literal.
  /simpara
 /note
 warning



-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php




[PHP-DOC] #18649 [Opn-Csd]: Documentation for array_diff incomplete

2002-07-30 Thread nohn

 ID:   18649
 Updated by:   [EMAIL PROTECTED]
 Reported By:  [EMAIL PROTECTED]
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: All
 PHP Version:  4CVS-2002-07-30
 New Comment:

This bug has been fixed in CVS. You can grab a snapshot of the
CVS version at http://snaps.php.net/. In case this was a documentation 
problem, the fix will show up soon at http://www.php.net/manual/.
In case this was a PHP.net website problem, the change will show
up on the PHP.net site and on the mirror sites.
Thank you for the report, and for helping us make PHP better.




Previous Comments:


[2002-07-30 09:48:01] [EMAIL PROTECTED]

It should be mentioned that array_diff only checks one dimension of an
n-dimensional array.

for example:

Array
(
   [0] = Array
   (
[0] = test
[1] = lala
   )
)

is the same like 

Array
(
   [0] = Array
   (
[0] = test
[1] = bubu
   )
)

when checking Array with array_diff.

Only when checking Array[0] with array_diff it returns that the arrays
differ






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


-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php