Re: [PHP-DOC] time to switch the install section?

2004-08-06 Thread Dave Barr
Philip Olson wrote:
for it to go (into the attic).  As for the others, not sure why they even
exist!  Many contain deleted files but why do the directories remain?
It's a shortcoming of CVS. You can't "cvs remove" a directory as you 
would a file. The only way to remove a directory from CVS is by hacking 
the repository directly.

Using the -P option for update/checkout (which you should do anyway) you 
can locally remove the empty directories but they'll still remain in the 
repository.

Regards,
Philip
Dave


[PHP-DOC] cvs: phpdoc /en/reference/network/functions inet-ntop.xml inet-pton.xml

2004-08-06 Thread Sara Golemon
pollita Sat Aug  7 01:13:16 2004 EDT

  Added files: 
/phpdoc/en/reference/network/functions  inet-ntop.xml inet-pton.xml 
  Log:
  Document inet_pton() and inet_aton()
  

http://cvs.php.net/co.php/phpdoc/en/reference/network/functions/inet-ntop.xml?r=1.1&p=1
Index: phpdoc/en/reference/network/functions/inet-ntop.xml
+++ phpdoc/en/reference/network/functions/inet-ntop.xml


  
   
inet_ntop

  Converts a packed internet address to a human readable representation
 
   
   
Description
 
  stringinet_ntop
  stringin_addr
 

 This function converts a 32bit IPv4, or 128bit IPv6 address (if PHP
 was built with IPv6 support enabled) into an address family appropriate 
 string representation.  Returns &false; on failure.


 inet_ntop Example
 

 



 See also long2ip,
 inet_pton, and
 ip2long.

   
  



http://cvs.php.net/co.php/phpdoc/en/reference/network/functions/inet-pton.xml?r=1.1&p=1
Index: phpdoc/en/reference/network/functions/inet-pton.xml
+++ phpdoc/en/reference/network/functions/inet-pton.xml


  
   
inet_pton

  Converts a human readable IP address to its packed in_addr representation
 
   
   
Description
 
  stringinet_pton
  stringaddress
 

 This function converts a human readable IPv4 or IPv6 address (if PHP
 was built with IPv6 support enabled) into an address family appropriate
 32bit or 128bit binary structure.


 inet_pton Example
 

 



 See also ip2long,
 inet_ntop, and
 long2ip.

   
  




[PHP-DOC] PHP 5 with Apache 2 install.txt

2004-08-06 Thread Shwu-Ying Chen

Hi,
 
I tried to install PHP 5 with Apache 2 server on Windows environment by following the instruction listed in the install.txt.
 
In the install.txt, it stated that we should have the following added in the httpd.conf.

LoadModule php5_module c:/php/php5apache.dllAddModule mod_php5.cAddType application/x-httpd-php .php
 
I tried but that does not work for me.  
 
I experimented and got it to work.  What I did is to load a differet dll and did not include the the AddModule line.
 

LoadModule php5_module c:/php/php5apache2.dllAddType application/x-httpd-php .php
 
I hope this helps others who have similar situations like mine.
 
Thanks!
Shwu-Ying
		Do you Yahoo!?
Yahoo! Mail - Helps protect you from nasty viruses.

Re: [PHP-DOC] time to switch the install section?

2004-08-06 Thread Philip Olson

> > I think now we could switch to the new installation section, as it is much
> > more up-to-date than the old/current section.
> > 
> > If noone objects, I'll upgrade the manual.xml.in,
> > scripts/file-entities.php.in, and remove the files in the chapter dir.
> 
> I would like to see the turnover, but the file removal is not needed for 
> the build to properly pick up the new files. Leaving the files might 
> only confuse people later (and some translations would even start to 
> translate it), so it is probably not a good idea to keep the old install 
> files. So I would vote for the switch and the removal of files. Those 
> who need it, will be able to find them in the attic.

If we're going to delete files how about we go all out and cleanup the
entire phpdoc tree?  Up for nomination are:

  dbxml/
  functions/
  ja/
  kr/
  php/
  phpdoc-th/
  test/

The only real issue I see is with functions/ but it may finally be time
for it to go (into the attic).  As for the others, not sure why they even
exist!  Many contain deleted files but why do the directories remain?

Regards,
Philip


[PHP-DOC] cvs: phpdoc /en/reference/curl/functions curl-setopt.xml

2004-08-06 Thread Dave Barr
daveFri Aug  6 20:53:26 2004 EDT

  Modified files:  
/phpdoc/en/reference/curl/functions curl-setopt.xml 
  Log:
  - Proto fix.
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/curl/functions/curl-setopt.xml?r1=1.10&r2=1.11&ty=u
Index: phpdoc/en/reference/curl/functions/curl-setopt.xml
diff -u phpdoc/en/reference/curl/functions/curl-setopt.xml:1.10 
phpdoc/en/reference/curl/functions/curl-setopt.xml:1.11
--- phpdoc/en/reference/curl/functions/curl-setopt.xml:1.10 Fri Aug  6 20:06:16 
2004
+++ phpdoc/en/reference/curl/functions/curl-setopt.xml  Fri Aug  6 20:53:26 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -11,7 +11,7 @@
  
   boolcurl_setopt
   resourcech
-  stringoption
+  integeroption
   mixedvalue
  
 


[PHP-DOC] #27202 [Opn->Csd]: document all curl constants

2004-08-06 Thread dave
 ID:   27202
 Updated by:   [EMAIL PROTECTED]
 Reported By:  leander2 at berwers dot com
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: Linux
 PHP Version:  Irrelevant
 New Comment:

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

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




Previous Comments:


[2004-07-25 02:01:26] [EMAIL PROTECTED]

Marking this as a documentation problem and rewriting the summary as
'document all curl constants'.

All curl constants should be documented (or perhaps mention that all
are not, at least until they are), here is a complete list:

http://lxr.php.net/source/php-src/ext/curl/interface.c#130

Wow, there sure are a lot of curl constants! :)  List of constants go
here:

http://cvs.php.net/phpdoc/en/reference/curl/constants.xml

Docs (with useful information) goes here:

http://cvs.php.net/phpdoc/en/reference/curl/functions/curl-setopt.xml



[2004-07-24 23:11:04] fido at list dot pl

Sorry to bother You, but could You point me to a place in manual where
this option is described?? 
I searched it a few times (with and without Ctrl+F) and couldn't find
it. Maybe this "feature" is not yet documented?
I've lost a few hours today fighting with this.. and gave up. I did it
by reinitiating CURL.



[2004-02-10 11:14:43] [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

You need to set curl_setopt($ch, CURLOPT_HTTPGET, 1); for 
the 2nd request, the  
curl_setopt($ch, CURLOPT_URL,"http://second";); 
curl_setopt($ch, CURLOPT_POST, 0); 
 
are not needed for request #2. 



[2004-02-10 04:46:46] leander2 at berwers dot com

Description:

CURLOPT_POST = 0 and/or CURLOPT_POSTFIELDS = null does actually do a
POST while a GET is required

Reproduce code:
---
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,"http://first";);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $b);
$x = curl_exec($ch);
curl_setopt($ch, CURLOPT_URL,"http://second";);
curl_setopt($ch, CURLOPT_POST, 0);
curl_setopt($ch, CURLOPT_POSTFIELDS, null);
curl_close($ch);  


Expected result:

The first request should be a POST and the second request should be a
GET. 

Actual result:
--
The first request is a POST (which is ok), but the second request is
also a POST.






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


[PHP-DOC] cvs: phpdoc /en/install/windows manual.xml

2004-08-06 Thread Yannick TORRES
yannick Fri Aug  6 19:52:21 2004 EDT

  Modified files:  
/phpdoc/en/install/windows  manual.xml 
  Log:
  typo
  
http://cvs.php.net/diff.php/phpdoc/en/install/windows/manual.xml?r1=1.13&r2=1.14&ty=u
Index: phpdoc/en/install/windows/manual.xml
diff -u phpdoc/en/install/windows/manual.xml:1.13 
phpdoc/en/install/windows/manual.xml:1.14
--- phpdoc/en/install/windows/manual.xml:1.13   Fri Aug  6 18:37:44 2004
+++ phpdoc/en/install/windows/manual.xmlFri Aug  6 19:52:21 2004
@@ -1,5 +1,5 @@
 
-
+

 Manual Installation Steps
 
@@ -23,7 +23,7 @@
  
   Previous editions of the manual suggest moving various ini and 
   DLL files into your SYSTEM (i.e. 
-  C:\WINDOWS) folder and while this 
+  C:\WINDOWS) folder and while this 
   simplifies the installation procedure it makes upgrading difficult.  We 
   advise you remove all of these files (like &php.ini; and PHP related
   DLLs from the Windows SYSTEM folder) before moving on with a new 


[PHP-DOC] cvs: phpdoc /en/language/oop5 decon.xml

2004-08-06 Thread Curt Zirzow
curtFri Aug  6 19:50:51 2004 EDT

  Modified files:  
/phpdoc/en/language/oop5decon.xml 
  Log:
  WS Fix
  
  
http://cvs.php.net/diff.php/phpdoc/en/language/oop5/decon.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/language/oop5/decon.xml
diff -u phpdoc/en/language/oop5/decon.xml:1.1 phpdoc/en/language/oop5/decon.xml:1.2
--- phpdoc/en/language/oop5/decon.xml:1.1   Sun Jul 11 08:33:25 2004
+++ phpdoc/en/language/oop5/decon.xml   Fri Aug  6 19:50:50 2004
@@ -1,92 +1,93 @@
 
-
+
  
   Constructors and Destructors
+
   
-Constructor
-
- PHP 5 allows developers to declare constructor methods for classes.
- Classes which have a constructor method call this method on each
- newly-created object, so it is suitable for any initialization that the
- object may need before it is used.
-
-
- 
-  Parent constructors are not called implicitly.  In order to run
-  a parent constructor, a call to
-  parent::__construct is required.
- 
-
-
- using new unified constructors
- 
+   Constructor
+   
+PHP 5 allows developers to declare constructor methods for classes.
+Classes which have a constructor method call this method on each
+newly-created object, so it is suitable for any initialization that the
+object may need before it is used.
+   
+   
+
+ Parent constructors are not called implicitly.  In order to run
+ a parent constructor, a call to
+ parent::__construct is required.
+
+   
+   
+using new unified constructors
+
 
- 
-
-
- For backwards compatibility, if PHP 5 cannot find a 
- __construct function for a given class, it will
- search for the old-style constructor function, by the name of the class.
- Effectively, it means that the only case that would have compatibility
- issues is if the class had a method named 
- __construct which was used for different semantics.
-
+
+   
+   
+For backwards compatibility, if PHP 5 cannot find a 
+__construct function for a given class, it will
+search for the old-style constructor function, by the name of the class.
+Effectively, it means that the only case that would have compatibility
+issues is if the class had a method named 
+__construct which was used for different semantics.
+   
   
 
   
-Destructor
-
- PHP 5 introduces a destructor concept similar to that of other
- object-oriented languages, such as Java: When the last reference to an
- object is destroyed the object's destructor, which is a class method
- named __destruct  that receives no parameters, is
- called before the object is freed from memory.
-
-
- Destructor Example
- 
+   Destructor
+   
+PHP 5 introduces a destructor concept similar to that of other
+object-oriented languages, such as Java: When the last reference to an
+object is destroyed the object's destructor, which is a class method
+named __destruct  that receives no parameters, is
+called before the object is freed from memory.
+   
+   
+Destructor Example
+
 
- 
-
-
- Like constructors, parent destructors will not be called implicitly by
- the engine. In order to run a parent destructor, one would have to
- explicitly call parent::__destruct in the destructor
- body.
-
+
+   
+   
+Like constructors, parent destructors will not be called implicitly by
+the engine. In order to run a parent destructor, one would have to
+explicitly call parent::__destruct in the destructor
+body.
+   
   
 
  




[PHP-DOC] #28255 [Com]: DLL directory missing

2004-08-06 Thread steve at aquiel dot net
 ID:   28255
 Comment by:   steve at aquiel dot net
 Reported By:  pburden98 at yahoo dot com
 Status:   Assigned
 Bug Type: Documentation problem
 Operating System: windows 98 2nd Edition
 PHP Version:  5.0.0RC2
 Assigned To:  nlopess
 New Comment:

Bring back the dll directory so we can see which ones need to be put
into system32

ok it might all run from the one directory but as a sysadmin running it
form that one directory involves changes to enviromental variables etc
to get php5 working properly

and please update your documentation to reflect any changes!!! the
installation docs are far from easy to read


Previous Comments:


[2004-07-16 04:30:12] bradley at scrapcode dot com

There is no dlls/ directory - the dlls in the root directory of php
work, but without copying them to system32 during an upgrade, many
problems arise.



[2004-05-05 13:28:38] pburden98 at yahoo dot com

I found another on line 181 of INSTALL.

"Since PHP 4.0.5 MySQL, ODBC, FTP...and XML support is built-in."

This is not true.  I was told by a friend, "MySQL is not loaded because
of licensing problems"

Will you be patching the whole chapter "Installation of Windows
extensions" on the INSTALL?



[2004-05-03 15:32:19] [EMAIL PROTECTED]

I don't have karma to update the INSTALL file, but I'll make a patch
for it and I'll update this in the migration appendix.



[2004-05-03 13:51:21] [EMAIL PROTECTED]

That's correct; we moved them to avoid the need to put anything outside
of you PHP install dir, as that causes people many problems when they
upgrade (they always forget to check their system dir).

Making this a documentation problem.



[2004-05-03 13:14:27] bart at mediawave dot nl

I'm not an official bugs administrator but I might know the answer. 

I think they moved the files in the dlls directory into the main
directory. (Where php.exe is) As far as I know, with PHP5, you don't
need to copy/move any files to your windows and system32 directories
anymore. Just extract the zipfile into a directory. Edit php.ini.
Create the mappings in IIS. (.php > C:\your-installation-dir\php.exe).
Restart IIS. And it should work.

Also, make sure that you remove any php files from your windows and
system32 directory from previous PHP installations.



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/28255

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


[PHP-DOC] #26808 [Opn->Csd]: Russian docs error in the name of Stig

2004-08-06 Thread vrana
 ID:   26808
 Updated by:   [EMAIL PROTECTED]
 Reported By:  abonentu at pisem dot net
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: N/A
 PHP Version:  irrelevant
 New Comment:

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

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

He was replaced by more current authors :-). Please wait until russian
translation team update the documentation.


Previous Comments:


[2004-01-07 05:15:17] [EMAIL PROTECTED]

Don't know how the summary was changed...



[2004-01-07 05:12:56] [EMAIL PROTECTED]

Docproblem.



[2004-01-06 02:32:26] abonentu at pisem dot net

Description:

PHP documentation in Russian hosted at http://www.php.net/manual/ru/
has an error already at the second line - in the name of Mr. Bakken.
There's a nonstandard letter used in the name S[ae]ther - ligature ae.
Because of using Russian 8bit charset, this letter removed by Russian
letter [zh] (U+0436).

Reproduce code:
---
http://www.php.net/manual/ru/ (twice)

Expected result:

The æ or æ entity reference should be use instead of simple
letter.

Actual result:
--
Now I see at my screen something like:
Stig Sжther Bakken





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


[PHP-DOC] cvs: phpdoc / install.xml

2004-08-06 Thread Nuno Lopes
nlopess Fri Aug  6 18:48:11 2004 EDT

  Removed files:   
/phpdoc install.xml 
  Log:
  remove remaining file
  


[PHP-DOC] #25066 [Opn->Bgs]: notls is not mentioned as an option.

2004-08-06 Thread vrana
 ID:   25066
 Updated by:   [EMAIL PROTECTED]
 Reported By:  juman at gwu dot edu
-Status:   Open
+Status:   Bogus
 Bug Type: Documentation problem
 Operating System: Irrlevant
 PHP Version:  Irrelevant
 New Comment:

Duplicate to bug #27017 (there are more information).


Previous Comments:


[2003-08-12 22:34:36] juman at gwu dot edu

Description:

A few options are missing including notls on the document

Reference page:
http://www.php.net/manual/en/function.imap-open.php


Reproduce code:
---
Documentation error. Follow the link 

http://www.php.net/manual/en/function.imap-open.php

Expected result:

Every option shuold be documented.


Actual result:
--
A few options are missing.





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


Re: [PHP-DOC] time to switch the install section?

2004-08-06 Thread Nuno Lopes
done!

now lets watch the user notes for problems :)

Nuno



> Gabor Hojtsy wrote:
> > Hi,
> >
> >> I've commit the activescript install instructions.
> >>
> >> I think now we could switch to the new installation section, as it is
> >> much
> >> more up-to-date than the old/current section.
> >>
> >> If noone objects, I'll upgrade the manual.xml.in,
> >> scripts/file-entities.php.in, and remove the files in the chapter dir.
> >
> >
> > I would like to see the turnover, but the file removal is not needed for
> > the build to properly pick up the new files. Leaving the files might
> > only confuse people later (and some translations would even start to
> > translate it), so it is probably not a good idea to keep the old install
> > files. So I would vote for the switch and the removal of files. Those
> > who need it, will be able to find them in the attic.
>
> Yep, it seems fine to me too
>
> +1
>
> didou


[PHP-DOC] cvs: phpdoc / .cvsignore installpart.xml.in manual.xml.in /en/appendices/configure index.xml /en/chapters README config.xml install.apache.xml install.apache2.xml install.caudium.xml install.commandline.xml install.fhttpd.xml install.general.xml install.hpux.xml install.iis.xml install.iplanet.xml install.linux.xml install.macosx.xml install.omnihttpd.xml install.openbsd.xml install.otherhttpd.xml install.problems.xml install.sambar.xml install.solaris.xml install.unix.xml install.windows.xml install.xitami.xml intro.xml tutorial.xml /en/install/windows manual.xml /en/language functions.xml /en/reference/mbstring configure.xml /scripts file-entities.php.in

2004-08-06 Thread Nuno Lopes
nlopess Fri Aug  6 18:37:45 2004 EDT

  Removed files:   
/phpdoc installpart.xml.in 
/phpdoc/en/chapters README config.xml install.apache.xml 
install.apache2.xml install.caudium.xml 
install.commandline.xml install.fhttpd.xml 
install.general.xml install.hpux.xml 
install.iis.xml install.iplanet.xml 
install.linux.xml install.macosx.xml 
install.omnihttpd.xml install.openbsd.xml 
install.otherhttpd.xml install.problems.xml 
install.sambar.xml install.solaris.xml 
install.unix.xml install.windows.xml 
install.xitami.xml 

  Modified files:  
/phpdoc .cvsignore manual.xml.in 
/phpdoc/en/appendices/configure index.xml 
/phpdoc/en/chapters intro.xml tutorial.xml 
/phpdoc/en/install/windows  manual.xml 
/phpdoc/en/language functions.xml 
/phpdoc/en/reference/mbstring   configure.xml 
/phpdoc/scripts file-entities.php.in 
  Log:
  finally switch to the new install part
  #going to sleep now :)
  http://cvs.php.net/diff.php/phpdoc/.cvsignore?r1=1.40&r2=1.41&ty=u
Index: phpdoc/.cvsignore
diff -u phpdoc/.cvsignore:1.40 phpdoc/.cvsignore:1.41
--- phpdoc/.cvsignore:1.40  Tue Oct 14 05:55:33 2003
+++ phpdoc/.cvsignore   Fri Aug  6 18:37:44 2004
@@ -35,7 +35,6 @@
 status.txt
 revcheck.html
 chmonly.xml
-installpart.xml
 reserved.constants.xml
 autom4te*
 missing-entities.out
http://cvs.php.net/diff.php/phpdoc/manual.xml.in?r1=1.182&r2=1.183&ty=u
Index: phpdoc/manual.xml.in
diff -u phpdoc/manual.xml.in:1.182 phpdoc/manual.xml.in:1.183
--- phpdoc/manual.xml.in:1.182  Tue Aug  3 07:52:56 2004
+++ phpdoc/manual.xml.inFri Aug  6 18:37:44 2004
@@ -2,7 +2,7 @@
 
+
 
 
 
@@ -55,11 +55,8 @@
   &GettingStarted;
   &chapters.intro;
   &chapters.tutorial;
-  &chapters.install; 
-  &chapters.config;
  
 
- 
  
  
   &LanguageReference;
http://cvs.php.net/diff.php/phpdoc/en/appendices/configure/index.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc/en/appendices/configure/index.xml
diff -u phpdoc/en/appendices/configure/index.xml:1.3 
phpdoc/en/appendices/configure/index.xml:1.4
--- phpdoc/en/appendices/configure/index.xml:1.3Sun Jun 20 06:23:11 2004
+++ phpdoc/en/appendices/configure/index.xmlFri Aug  6 18:37:44 2004
@@ -1,5 +1,5 @@
 
-
+
 
  Configure options
 
@@ -12,7 +12,7 @@
locations on the extension reference pages and not here. For a complete
up-to-date list of configure options, run ./configure --help
in your PHP source directory after running autoconf
-   (see also the Installation chapter).
+   (see also the Installation chapter).
You may also be interested in reading the
GNU configure documentation for
information on additional configure options such as
http://cvs.php.net/diff.php/phpdoc/en/chapters/intro.xml?r1=1.37&r2=1.38&ty=u
Index: phpdoc/en/chapters/intro.xml
diff -u phpdoc/en/chapters/intro.xml:1.37 phpdoc/en/chapters/intro.xml:1.38
--- phpdoc/en/chapters/intro.xml:1.37   Sun May 23 15:32:27 2004
+++ phpdoc/en/chapters/intro.xmlFri Aug  6 18:37:44 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Introduction
 
@@ -91,7 +91,7 @@
viewing the PHP page through the server. All these can
run on your home machine if you are just experimenting
with PHP programming. See the
-   installation instructions
+   installation instructions
section for more information.
   
  
@@ -229,7 +229,7 @@

 As you can see this page is not enough to list all
 the features and benefits PHP can offer. Read on in
-the sections about installing
+the sections about installing
 PHP, and see the function
 reference part for explanation of the extensions
 mentioned here.
http://cvs.php.net/diff.php/phpdoc/en/chapters/tutorial.xml?r1=1.35&r2=1.36&ty=u
Index: phpdoc/en/chapters/tutorial.xml
diff -u phpdoc/en/chapters/tutorial.xml:1.35 phpdoc/en/chapters/tutorial.xml:1.36
--- phpdoc/en/chapters/tutorial.xml:1.35Mon Jul 19 21:27:19 2004
+++ phpdoc/en/chapters/tutorial.xml Fri Aug  6 18:37:44 2004
@@ -1,5 +1,5 @@
 
-
+
  
   A simple tutorial
 
@@ -44,7 +44,7 @@


 You can either install these individually or choose a simpler way. Our
-manual has installation instructions for
+manual has installation instructions for
 PHP (assuming you already have some webserver set up). In case
 you have problems with installing PHP yourself, we would suggest you ask
 your questions on our installation
@@ -120,7 +120,7 @@
 for download, or you see the whole file as text, chances are that the 
 server you are on does not have PHP enabled, or is not configured properly.
 Ask your administrator to enable it for you using the
-Installation chapter 
+Installation chapter 
 of

[PHP-DOC] #24931 [Opn->Csd]: call_user_func ignores requirement of references

2004-08-06 Thread vrana
 ID:   24931
 Updated by:   [EMAIL PROTECTED]
 Reported By:  rehsack at liwing dot de
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: FreeBSD 5.1 i386
 PHP Version:  4.3.3RC2, 5.0.0b2-dev
 New Comment:

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

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

"Note that the parameters for call_user_func are not passed by
reference." + example:





Previous Comments:


[2003-08-05 02:29:54] rehsack at liwing dot de

Documentation says:

call_user_func

(PHP 3>= 3.0.3, PHP 4 )
call_user_func --  Call a user function given by the first parameter
Description
mixed call_user_func ( callback function [, mixed parameter [, mixed
...]])

Call a user defined function given by the function parameter. Take the
following: 
 ...

I consider update the documentation by directly writing:

"This method doesn't take care about using parameters
as references as long as you specify the at calltime, which
should be enabled via php.ini even if it's deprecated, because there's
no other way to call this method using
references.
We consider to use call_user_func_array( func_name, array( &$param ) )
if you want to use references."



[2003-08-04 19:34:57] [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

I admit that the error is misleading, because it cannot tell that
function was not executed directly but rather via call_user_func().
However, the actual functionality of the code is correct. The variable
is not passed by reference to call_user_func(), hence making it pass a
copy to nextID(). The documentation does not mention that you can pass
variables by reference and that's because in this case you cannot.



[2003-08-04 17:06:16] rehsack at liwing dot de

Hi Ilia,

your wrong, because:
$ cat test1.php


$ php test1.php

Warning: Call-time pass-by-reference has been deprecated - argument
passed by value;  If you would like to pass it by reference, modify the
declaration of call_
user_func().  If you would like to enable call-time pass-by-reference,
you can set allow_call_time_pass_reference to true in your INI file. 
However, future versions may not support this any longer.  in
/var/www/data/trevor/flexpage/test/php-bugs/test1.php on line 10
before call_user_func id=1
after call_user_func id=2
after call_user_func_array id=3

This gives the wanted result but prints out a warning.
By the way, I don't want to discus whether call_user_func is
implemented as described neither it's not working as designed. I want
to tell you (as php team), that the design
might be wrong.

Either, if you (as php team) don't have any plans to extend
the design (what shouldn't be to complicated), I consider you update
the documentation that way, that you describe
that call_user_func will duplicate the given argument.

call_user_func is not an intelligent function (what it
could be), it's a dumb one (this is not an offending but
it is like a dumb terminal as some old unix ones).

I want to consider by this bug report to rewrite call_user_func becomes
intelligent (looks what kind of
argument is required and calls that way).

Otherwise I had to open a documentation bug, because this
behaviour should be documented explicitely.



[2003-08-04 13:37:42] [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

$id is modified because the original $id passed to  call_user_func() is
not being passed by reference.



[2003-08-04 03:22:31] rehsack at liwing dot de

Description:

The method call_user_func ignores requirement of called
function takes it's arguments as reference. The results
in several times very ugly and hard to find bugs, eg. if
you use a template pattern combined with composite to
control child templates and want to do an action in each
child object and require to work on current data copy.

Either, if call_user_func internally is able to be called
by reference, some programs could be speed up, too (because
of the loose of expensive string copies)

This bug may related to #24631 but seems

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

2004-08-06 Thread Sean Coates
seanFri Aug  6 17:57:41 2004 EDT

  Modified files:  
/phpdoc/en/reference/sessionreference.xml 
  Log:
  grammar
  
http://cvs.php.net/diff.php/phpdoc/en/reference/session/reference.xml?r1=1.48&r2=1.49&ty=u
Index: phpdoc/en/reference/session/reference.xml
diff -u phpdoc/en/reference/session/reference.xml:1.48 
phpdoc/en/reference/session/reference.xml:1.49
--- phpdoc/en/reference/session/reference.xml:1.48  Fri Aug  6 17:52:31 2004
+++ phpdoc/en/reference/session/reference.xml   Fri Aug  6 17:57:41 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Session Handling Functions
   Sessions
@@ -214,7 +214,7 @@
 
  
   You can't use references in session variables as there is no feasible way
-  to restore reference to other variable.
+  to restore a reference to another variable.
  
 
 


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

2004-08-06 Thread Jakub Vrana
vrana   Fri Aug  6 17:52:31 2004 EDT

  Modified files:  
/phpdoc/en/reference/sessionreference.xml 
  Log:
  Don't use reference in sessions (bug #16387)
  
http://cvs.php.net/diff.php/phpdoc/en/reference/session/reference.xml?r1=1.47&r2=1.48&ty=u
Index: phpdoc/en/reference/session/reference.xml
diff -u phpdoc/en/reference/session/reference.xml:1.47 
phpdoc/en/reference/session/reference.xml:1.48
--- phpdoc/en/reference/session/reference.xml:1.47  Mon Jul 19 21:27:19 2004
+++ phpdoc/en/reference/session/reference.xml   Fri Aug  6 17:52:31 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Session Handling Functions
   Sessions
@@ -211,6 +211,12 @@
   
  
 
+
+ 
+  You can't use references in session variables as there is no feasible way
+  to restore reference to other variable.
+ 
+
 
  
   


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

2004-08-06 Thread Sean Coates
seanFri Aug  6 17:45:13 2004 EDT

  Modified files:  
/phpdoc/en/language references.xml 
  Log:
  grammar
  
http://cvs.php.net/diff.php/phpdoc/en/language/references.xml?r1=1.34&r2=1.35&ty=u
Index: phpdoc/en/language/references.xml
diff -u phpdoc/en/language/references.xml:1.34 phpdoc/en/language/references.xml:1.35
--- phpdoc/en/language/references.xml:1.34  Fri Aug  6 17:39:39 2004
+++ phpdoc/en/language/references.xml   Fri Aug  6 17:45:13 2004
@@ -1,5 +1,5 @@
 
-
+
  
   References Explained
 
@@ -205,7 +205,7 @@
 variable contents and not name-to-value binding in the calling
 symbol table).
 You can use returning
-references to reference variable selected by the function.
+references to reference variables selected by the function.

   
 


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

2004-08-06 Thread Jakub Vrana
vrana   Fri Aug  6 17:39:40 2004 EDT

  Modified files:  
/phpdoc/en/language references.xml 
  Log:
  See also
  
http://cvs.php.net/diff.php/phpdoc/en/language/references.xml?r1=1.33&r2=1.34&ty=u
Index: phpdoc/en/language/references.xml
diff -u phpdoc/en/language/references.xml:1.33 phpdoc/en/language/references.xml:1.34
--- phpdoc/en/language/references.xml:1.33  Fri Aug  6 05:00:04 2004
+++ phpdoc/en/language/references.xml   Fri Aug  6 17:39:39 2004
@@ -1,5 +1,5 @@
 
-
+
  
   References Explained
 
@@ -204,6 +204,8 @@
 $var, but $var has only
 variable contents and not name-to-value binding in the calling
 symbol table).
+You can use returning
+references to reference variable selected by the function.

   
 


[PHP-DOC] #26484 [Opn->Bgs]: "Returning References" could do with more info

2004-08-06 Thread vrana
 ID:   26484
 Updated by:   [EMAIL PROTECTED]
 Reported By:  sdavey at datalink dot net dot au
-Status:   Open
+Status:   Bogus
 Bug Type: Documentation problem
 Operating System: NA
 PHP Version:  4.3.2
 New Comment:

It's illegal to omit one or the other & thus there is "you have to use
& in both places". In current PHP versions (4.3.8, 5.0.0) it seems that
& in function declaration is informative only but it can change in the
future.


Previous Comments:


[2003-12-01 06:22:50] sdavey at datalink dot net dot au

Description:

The Returning References manual page contains the following comment:

"Note:  Unlike parameter passing, here you have to use & in both places
- to indicate that you return by-reference, not a copy as usual, and to
indicate that reference binding, rather than usual assignment, should
be done for $foo."

It refers to pass-by-reference, where you have to use the ampersand in
both the function *and* in the assignment of the function value to a
variable.

It is not clear what would happen if you didn't put the ampersand in
both places, and it would be nice to have someone explain this.

I'm a fairly seasoned PHP developer, but references are complex, and
judging by the user comments in various places in the manual concerning
them I think it would be great to have a sentance or two clarify this.

I know it's only a minor request, but for developers seeking to
fine-tune their code, understanding references is clearly the way to
go.

Thanks, Scott.






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


[PHP-DOC] #22198 [Ana->Csd]: date() returning incorrect date

2004-08-06 Thread vrana
 ID:   22198
 Updated by:   [EMAIL PROTECTED]
 Reported By:  jm at sindigit dot pt
-Status:   Analyzed
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: Solaris 8 (sparc)
 PHP Version:  4.3.0
 New Comment:

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

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

"Some times are invalid if DST is on. If DST is enabled in e.g. 2:00,
all times between 2:00 and 3:00 are invalid and mktime returns
undefined (usually negative) value. Some systems (e.g. Solaris 8)
enable DST in midnight so time 0:30 of the day when DST is enabled is
evaluated as 23:30 of the previous day."


Previous Comments:


[2004-02-16 10:31:26] php at neworld dot us

I am running windows2k, php4.3.4, apache 2.0.48 and I encounter the
same issue with this code.


Outputs:
1080428400
1080428400



[2003-05-17 04:36:29] jim at babylamb dot com

I have the same problem running on Mac OS X

php -q -r 'print mktime(0,0,0,3,30,2003) . "\n";'
-3662

Same happens for 3/31/2003 so is clearly related to DST.



[2003-03-31 09:40:20] jim dot hatfield at insignia dot com

Ditto on FreeBSD 4.7:

echo mktime(0, 0, 0, 3, 29, 2003) . "\n";
echo mktime(0, 0, 0, 3, 30, 2003) . "\n";
echo mktime(0, 0, 0, 3, 31, 2003) . "\n";

gives:

1048896000
-3662
1049065200

This from a machine in the UK, where we switched to DST
on the date in question.



[2003-02-21 10:26:47] say_ten at multiplay dot co dot uk

I have a very similar problem to this but with much more severe
symptoms.

sol# php -v
PHP 4.3.0 (cli) (built: Feb  1 2003 23:36:25)
Copyright (c) 1997-2002 The PHP Group
Zend Engine v1.3.0, Copyright (c) 1998-2002 Zend Technologies
sol# uname -sr
FreeBSD 4.7-STABLE
sol# php -q data.php
1048896000
29/03/2003
-3662
31/12/1969



[2003-02-13 16:51:35] jm at sindigit dot pt

$ zdump -v "Europe/Lisbon" | grep 2003
Europe/Lisbon  Sun Mar 30 00:59:59 2003 UTC = Sun Mar 30 00:59:59 2003
WET isdst
=0 gmtoff=0
Europe/Lisbon  Sun Mar 30 01:00:00 2003 UTC = Sun Mar 30 02:00:00 2003
WEST isds
t=1 gmtoff=3600
Europe/Lisbon  Sun Oct 26 00:59:59 2003 UTC = Sun Oct 26 01:59:59 2003
WEST isds
t=1 gmtoff=3600
Europe/Lisbon  Sun Oct 26 01:00:00 2003 UTC = Sun Oct 26 01:00:00 2003
WET isdst
=0 gmtoff=0
$



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/22198

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


[PHP-DOC] cvs: phpdoc /en/reference/datetime/functions mktime.xml

2004-08-06 Thread Jakub Vrana
vrana   Fri Aug  6 17:01:24 2004 EDT

  Modified files:  
/phpdoc/en/reference/datetime/functions mktime.xml 
  Log:
  Enabling DST (bug #22198)
  
http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/functions/mktime.xml?r1=1.10&r2=1.11&ty=u
Index: phpdoc/en/reference/datetime/functions/mktime.xml
diff -u phpdoc/en/reference/datetime/functions/mktime.xml:1.10 
phpdoc/en/reference/datetime/functions/mktime.xml:1.11
--- phpdoc/en/reference/datetime/functions/mktime.xml:1.10  Fri Aug  6 15:45:39 
2004
+++ phpdoc/en/reference/datetime/functions/mktime.xml   Fri Aug  6 17:01:23 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -48,6 +48,13 @@
   is_dst was added in 3.0.10.
  
 
+
+ Some times are invalid if DST is on. If DST is enabled in e.g. 2:00, all
+ times between 2:00 and 3:00 are invalid and mktime
+ returns undefined (usually negative) value. Some systems (e.g. Solaris 8)
+ enable DST in midnight so time 0:30 of the day when DST is enabled is
+ evaluated as 23:30 of the previous day.
+
 
  mktime is useful for doing date arithmetic
  and validation, as it will automatically calculate the correct


[PHP-DOC] #14391 [Opn->Csd]: gmmktime, gmdate work incorrect

2004-08-06 Thread vrana
 ID:   14391
 Updated by:   [EMAIL PROTECTED]
 Reported By:  pilots at farlep dot net
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: Windows 2000 Server
 PHP Version:  4CVS/5CVS
 New Comment:

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

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

"Parameters always represent a GMT date so is_dst doesn't influence the
result."


Previous Comments:


[2003-09-03 07:33:38] [EMAIL PROTECTED]

From: Luke Ehresman 

Derick,

Alright, after analyzing every line of the php_mktime() function, I
finally figured out the problem.  There isn't actually a bug.  However,
the PHP documentation is very deceptive.  The 7th parameter of the
gmmktime function does not perform expected behavior.  In reality,
there is no need for the functionality that it does provide.  The only
reason it is there is so it is virtually the same as the mktime()
function.

Anyhow..  By reading the documentation, what I gathered that it would
do was to apply a daylight savings time offset to the GMT timestamp
before returning.  What it really is doing is turning on or off the
feature of compensating for the fact that the C "mktime" function
already applied the server's daylight savings time preference.

With gmmktime, we should ALWAYS compensate for that.  I see no possible
reason that you would not want to.

Anyhow, I think I am not the only one to get confused by this stuff.
Perhaps it would be a good idea to either updating the documentation,
or making the interfaces a little clearer in PHP, or both.

I'm kinda disappointed that it wasn't a bug though.  I was looking
forward to having my PHP patch accepted.  :)

Thanks for your help,
Luke




[2003-08-18 19:22:27] lehresma at css dot tayloru dot edu

Posted this on php-dev and was advised to put it here as well.
--
A co-worker and I have been working on some intensive
timestamp/timezone manipulation code for the past week or so, and ran
across what we believed to be a bug in the way PHP handled gmmktime(). 
Browsing through the code, sure enough I found the source of the
problem.  I fixed it, and have attached a patch.

As I was searching around, I discovered that this has been an open bug
since 4.0.6 (2 years!).  I believe that this patch should fix most of
the issues related to the following problem:
http://bugs.php.net/bug.php?id=14391


The Problem:

The function gmmktime() is supposed to take a date in GMT as a paramter
and return a timestamp in GMT.  No manipulation of the time should
occur. The only circumstance in which manipulation of the time should
happen is if the seventh  parameter (is_dst) is set to 1.  This is the
expected behavior.  However, in reality I noticed that when I didn't
specify a seventh parameter, it was applying a daylight savings time
offset when I tried to get the epoch.  See the example code.

";
echo gmmktime(0,0,0,1,1,1970,1)."\n";
echo gmmktime(0,0,0,1,1,1970,0)."\n";
echo gmmktime(0,0,0,1,1,1970)."\n";

// Now get timestamp for June 1
echo "\n";
echo gmmktime(0,0,0,6,1,1970,1)."\n";
echo gmmktime(0,0,0,6,1,1970,0)."\n";
echo gmmktime(0,0,0,6,1,1970)."\n";

?>

I expected the first set of outputs to look like this:

-3600
0
0

Which it does, so this is fine.  However, The second block of outputs
is in June which if I had been using simply mktime(), I would have
expected a DST offset (note: DST = daylight savings time) to be applied
by default (on the 3rd command).  However, since I'm using gmmktime() by
default no DST offset should be applied.  The odd behavior manifests 
itself in the second block of output:

13046400
1305
13046400

This is pretty meaningless until you realize what is actually going on.
The last output, which is generated by a gmmktime() that has no 7th
parameter, is applying an offset for daylight savings time.

The Solution

I had a moment of panic and was sincerely hoping that GMT did not
actually use daylight savings time, so I did some research and found
that while the timezone that contains Greenwich actually does use
daylight savings time, the GMT standard time reference does not.  So
right there I knew something was wrong on the PHP side.  I loaded up
the source of PHP (like a good open source enthusiast), and sure
enough, I discovered the source of the problem (no pun intended).

PHP is using the C function php_mktime() for both mktime() and
gmmktime(). There is a flag as a parameter called "gm" which is 1 or 0
depending on whether it was called from mktime() or gmmktime().  The
problem is that there

Re: [PHP-DOC] time to switch the install section?

2004-08-06 Thread Mehdi Achour
Gabor Hojtsy wrote:
Hi,
I've commit the activescript install instructions.
I think now we could switch to the new installation section, as it is 
much
more up-to-date than the old/current section.

If noone objects, I'll upgrade the manual.xml.in,
scripts/file-entities.php.in, and remove the files in the chapter dir.

I would like to see the turnover, but the file removal is not needed for 
the build to properly pick up the new files. Leaving the files might 
only confuse people later (and some translations would even start to 
translate it), so it is probably not a good idea to keep the old install 
files. So I would vote for the switch and the removal of files. Those 
who need it, will be able to find them in the attic.
Yep, it seems fine to me too
+1
didou


[PHP-DOC] cvs: phpdoc /en/reference/datetime/functions gmmktime.xml

2004-08-06 Thread Jakub Vrana
vrana   Fri Aug  6 16:12:01 2004 EDT

  Modified files:  
/phpdoc/en/reference/datetime/functions gmmktime.xml 
  Log:
  is_dst is useless (bug #14391)
  
http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/functions/gmmktime.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc/en/reference/datetime/functions/gmmktime.xml
diff -u phpdoc/en/reference/datetime/functions/gmmktime.xml:1.5 
phpdoc/en/reference/datetime/functions/gmmktime.xml:1.6
--- phpdoc/en/reference/datetime/functions/gmmktime.xml:1.5 Fri Aug  6 16:05:23 
2004
+++ phpdoc/en/reference/datetime/functions/gmmktime.xml Fri Aug  6 16:12:00 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -21,6 +21,10 @@
 
  Identical to mktime except the passed
  parameters represents a GMT date.
+
+
+ Parameters always represent a GMT date so is_dst
+ doesn't influence the result.
 
 
  Like mktime, arguments may be left out in order 


[PHP-DOC] #22635 [Csd]: 1.1.1970 <> 24 hours in [gm]mktime

2004-08-06 Thread vrana
 ID:   22635
 Updated by:   [EMAIL PROTECTED]
 Reported By:  jsteen at timecom dot com
 Status:   Closed
 Bug Type: Documentation problem
 Operating System: win32
 PHP Version:  4.3.1
 New Comment:

Unix epoch starts at 1:00 CET which is 0:00 GMT. It confused me a
little :-). As 1970-01-01 00:00:00 in local time can be before
1970-01-01 00:00:00 GMT, mktime() can return negative value which is
not supported on Windows.

gmmktime() uses mktime() internally so it fails on negative timestamp
returned by mktime(). I documented this.


Previous Comments:


[2004-08-06 21:30:25] [EMAIL PROTECTED]

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

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

Unix epoch starts at 1:00 and Windows doesn't support negative
timestamps. That's the problem.



[2003-04-08 05:15:53] f dot vulto at re-base dot com

Too easy to blame it on Windows as a bug.  I think it's the timezone
which is causing problems on Windows here as well.  See also my comment
on bug #14391: "gmmktime, gmdate work incorrect".  

Wouldn't things be fixed if PHP would just use the proper Windows API
calls for timezone conversions instead of relying on UNIX setting of TZ
environment variable?  The TZ variable on Windows isn't reliable for
Daylight Savings Time other than US rules or rules of local server
timezone.  I don't have PHP core coding experience so here are some
useful links, anyone? :-)

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vccore9
8/HTML/_crt__tzset.asp
http://archive.devx.com/premier/mgznarch/vbpj/1999/08aug99/mt0899.pdf
http://17slon.com/gp/gp/files/gptimezone.htm
http://www.thedelphimagazine.com/samples/1175/1175.htm


Freddy Vulto



[2003-03-19 04:19:32] jsteeen at timecom dot com

yes. please. add a comment to the online doc about the win bugs to both
mktime and gmmktime.



[2003-03-17 09:42:36] [EMAIL PROTECTED]

This is not bug in PHP, but in Windows.
We should mention this on the manual.




[2003-03-17 08:52:33] jsteen at timecom dot com

michael:
"on systems where time_t is a 32bit signed integer, as most common
today, the valid range for year is somewhere between 1902 and 2037"

to my understanding, that includes 1970, in the valid range, or not?
[1902<1970<2037] 


andrew:
it seems your post is incomplete, so if you could complete, it, it
might be of some help. 

then: i basically agree, but: this is a bug-db. the first thing we can
do for the developers AND the community, is to report and document bugs
properly. if a bug then gets marked as 'bogus', it will be ignored, i
ensure you! so: 
maybe it's not as much as to 'get rid' of open bug-reports, but more
about marking them properly if you see one. if there are 'unsolvable'
bugs, i suggest they be marked as such [or as 'cannot be fixed at this
point'] and not as 'bogus'. that would also make it easier for us to
spot where the developers need help and kick in appropriately.

your redirection to mktime only proves that any function dealing with
unix timestamps is completely unreliable on win platforms and should
-hence- not(!) be used. i consider this fact being worth documented
somewhere.
[eg: a db based on timestamps cannot be moved to another OS, since the
stamps would 'shift']



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/22635

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


[PHP-DOC] cvs: phpdoc /en/reference/datetime/functions gmmktime.xml

2004-08-06 Thread Jakub Vrana
vrana   Fri Aug  6 16:05:24 2004 EDT

  Modified files:  
/phpdoc/en/reference/datetime/functions gmmktime.xml 
  Log:
  gmmktime uses mktime (bug #22635 again)
  
http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/functions/gmmktime.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc/en/reference/datetime/functions/gmmktime.xml
diff -u phpdoc/en/reference/datetime/functions/gmmktime.xml:1.4 
phpdoc/en/reference/datetime/functions/gmmktime.xml:1.5
--- phpdoc/en/reference/datetime/functions/gmmktime.xml:1.4 Sat Dec 20 23:21:43 
2003
+++ phpdoc/en/reference/datetime/functions/gmmktime.xml Fri Aug  6 16:05:23 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -26,6 +26,24 @@
  Like mktime, arguments may be left out in order 
  from right to left, with any omitted arguments being set to the
  current corresponding GMT value.
+
+
+ 
+  
+   gmmktime internaly uses mktime
+   so only times valid in derived local time can be used.
+  
+ 
+ 
+  gmmktime on Windows boundary
+  
+
+  
+ 
 

   


[PHP-DOC] cvs: phpdoc /en/reference/datetime/functions mktime.xml

2004-08-06 Thread Jakub Vrana
vrana   Fri Aug  6 15:45:40 2004 EDT

  Modified files:  
/phpdoc/en/reference/datetime/functions mktime.xml 
  Log:
  Revert (1:00 CET is 0:00 GMT)
  
http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/functions/mktime.xml?r1=1.9&r2=1.10&ty=u
Index: phpdoc/en/reference/datetime/functions/mktime.xml
diff -u phpdoc/en/reference/datetime/functions/mktime.xml:1.9 
phpdoc/en/reference/datetime/functions/mktime.xml:1.10
--- phpdoc/en/reference/datetime/functions/mktime.xml:1.9   Fri Aug  6 15:30:47 
2004
+++ phpdoc/en/reference/datetime/functions/mktime.xml   Fri Aug  6 15:45:39 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -28,7 +28,7 @@
 
  Returns the Unix timestamp corresponding to the arguments
  given. This timestamp is a long integer containing the number of
- seconds between the Unix Epoch (January 1 1970 01:00:00) and the time
+ seconds between the Unix Epoch (January 1 1970) and the time
  specified.
 
 


Re: [PHP-DOC] cvs: phpdoc /en/install/windows installer.xml manual.xml

2004-08-06 Thread Philip Olson
> >   Modified files:  
> > /phpdoc/en/install/windows  installer.xml manual.xml 
> >   Log:
> >   A fairly major update.
> 
> Quite a general commit message for such a big commit. What was in? 
> Language/grammar fixes?

Language, grammar, content, whitespace... everything.  I figured
I'd do it all together since this hasn't been translated yet.

Regards,
Philip


[PHP-DOC] cvs: phpdoc /en/reference/network/functions checkdnsrr.xml dns-get-record.xml

2004-08-06 Thread Sara Golemon
pollita Fri Aug  6 15:39:06 2004 EDT

  Modified files:  
/phpdoc/en/reference/network/functions  dns-get-record.xml 
checkdnsrr.xml 
  Log:
  A6 support added
  
http://cvs.php.net/diff.php/phpdoc/en/reference/network/functions/dns-get-record.xml?r1=1.18&r2=1.19&ty=u
Index: phpdoc/en/reference/network/functions/dns-get-record.xml
diff -u phpdoc/en/reference/network/functions/dns-get-record.xml:1.18 
phpdoc/en/reference/network/functions/dns-get-record.xml:1.19
--- phpdoc/en/reference/network/functions/dns-get-record.xml:1.18   Thu Dec 18 
09:14:34 2003
+++ phpdoc/en/reference/network/functions/dns-get-record.xmlFri Aug  6 15:39:06 
2004
@@ -1,5 +1,5 @@
 
-
+
   
 
  dns_get_record
@@ -86,7 +86,7 @@
   DNS_NS, DNS_PTR, 
   DNS_SOA, DNS_TXT, 
   DNS_, DNS_SRV,
-  DNS_NAPTR,
+  DNS_NAPTR, DNS_A6,
   DNS_ALL or DNS_ANY.
   The default is DNS_ANY.  
   
@@ -196,6 +196,17 @@
   
   
ipv6: IPv6 address
+  
+ 
+ 
+  A6(PHP >= 5.1.0)
+  
+   masklen: Length (in bits) to inherit from the target
+   specified by chain.
+   ipv6: Address for this specific record to merge with
+   chain.
+   chain: Parent record to merge with 
+   ipv6 data.
   
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/network/functions/checkdnsrr.xml?r1=1.6&r2=1.7&ty=u
Index: phpdoc/en/reference/network/functions/checkdnsrr.xml
diff -u phpdoc/en/reference/network/functions/checkdnsrr.xml:1.6 
phpdoc/en/reference/network/functions/checkdnsrr.xml:1.7
--- phpdoc/en/reference/network/functions/checkdnsrr.xml:1.6Wed Nov  5 18:13:37 
2003
+++ phpdoc/en/reference/network/functions/checkdnsrr.xmlFri Aug  6 15:39:06 
2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -24,7 +24,7 @@
 
 
  type may be any one of: A, MX, NS, SOA,
- PTR, CNAME, , or ANY.  The default is MX.
+ PTR, CNAME, , A6, SRV, NAPTR or ANY.  The default is MX.
 
 
  Host may either be the IP address in


[PHP-DOC] cvs: phpdoc /en/reference/datetime/functions mktime.xml

2004-08-06 Thread Jakub Vrana
vrana   Fri Aug  6 15:30:47 2004 EDT

  Modified files:  
/phpdoc/en/reference/datetime/functions mktime.xml 
  Log:
  Unix epoch starts at 1:00 (bug #22635)
  
http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/functions/mktime.xml?r1=1.8&r2=1.9&ty=u
Index: phpdoc/en/reference/datetime/functions/mktime.xml
diff -u phpdoc/en/reference/datetime/functions/mktime.xml:1.8 
phpdoc/en/reference/datetime/functions/mktime.xml:1.9
--- phpdoc/en/reference/datetime/functions/mktime.xml:1.8   Sat Dec 20 23:21:43 
2003
+++ phpdoc/en/reference/datetime/functions/mktime.xml   Fri Aug  6 15:30:47 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -28,7 +28,7 @@
 
  Returns the Unix timestamp corresponding to the arguments
  given. This timestamp is a long integer containing the number of
- seconds between the Unix Epoch (January 1 1970) and the time
+ seconds between the Unix Epoch (January 1 1970 01:00:00) and the time
  specified.
 
 


[PHP-DOC] #22635 [Ana->Csd]: 1.1.1970 <> 24 hours in [gm]mktime

2004-08-06 Thread vrana
 ID:   22635
 Updated by:   [EMAIL PROTECTED]
 Reported By:  jsteen at timecom dot com
-Status:   Analyzed
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: win32
 PHP Version:  4.3.1
 New Comment:

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

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

Unix epoch starts at 1:00 and Windows doesn't support negative
timestamps. That's the problem.


Previous Comments:


[2003-04-08 05:15:53] f dot vulto at re-base dot com

Too easy to blame it on Windows as a bug.  I think it's the timezone
which is causing problems on Windows here as well.  See also my comment
on bug #14391: "gmmktime, gmdate work incorrect".  

Wouldn't things be fixed if PHP would just use the proper Windows API
calls for timezone conversions instead of relying on UNIX setting of TZ
environment variable?  The TZ variable on Windows isn't reliable for
Daylight Savings Time other than US rules or rules of local server
timezone.  I don't have PHP core coding experience so here are some
useful links, anyone? :-)

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vccore9
8/HTML/_crt__tzset.asp
http://archive.devx.com/premier/mgznarch/vbpj/1999/08aug99/mt0899.pdf
http://17slon.com/gp/gp/files/gptimezone.htm
http://www.thedelphimagazine.com/samples/1175/1175.htm


Freddy Vulto



[2003-03-19 04:19:32] jsteeen at timecom dot com

yes. please. add a comment to the online doc about the win bugs to both
mktime and gmmktime.



[2003-03-17 09:42:36] [EMAIL PROTECTED]

This is not bug in PHP, but in Windows.
We should mention this on the manual.




[2003-03-17 08:52:33] jsteen at timecom dot com

michael:
"on systems where time_t is a 32bit signed integer, as most common
today, the valid range for year is somewhere between 1902 and 2037"

to my understanding, that includes 1970, in the valid range, or not?
[1902<1970<2037] 


andrew:
it seems your post is incomplete, so if you could complete, it, it
might be of some help. 

then: i basically agree, but: this is a bug-db. the first thing we can
do for the developers AND the community, is to report and document bugs
properly. if a bug then gets marked as 'bogus', it will be ignored, i
ensure you! so: 
maybe it's not as much as to 'get rid' of open bug-reports, but more
about marking them properly if you see one. if there are 'unsolvable'
bugs, i suggest they be marked as such [or as 'cannot be fixed at this
point'] and not as 'bogus'. that would also make it easier for us to
spot where the developers need help and kick in appropriately.

your redirection to mktime only proves that any function dealing with
unix timestamps is completely unreliable on win platforms and should
-hence- not(!) be used. i consider this fact being worth documented
somewhere.
[eg: a db based on timestamps cannot be moved to another OS, since the
stamps would 'shift']



[2003-03-12 15:37:51] [EMAIL PROTECTED]

jsteen at timecom dot com:

If you're pissed that the time functions are so 'buggy' on Win32, then
why don't you step into the ring and help us debug it?  Become part of
the community, but don't drive the community away because you didn't
get an answer you wanted.

Please reopen this bug as you feel necessary, but i'm marking it as a
bogus report due to the fact that it's an imcompatibility between Win32
and *nix systems, and also the fact that we can

I'd finally like to redirect you to
http://www.php.net/manual/en/function.mktime.php so you can read the
user comments.  Apparently different windows systems handle the
timestamp differently.  As said earlier, it's an incompatibility.

~ Andrew Heebner
~ Andrew Heebner



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/22635

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


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

2004-08-06 Thread Sean Coates
seanFri Aug  6 15:26:12 2004 EDT

  Modified files:  
/phpdoc/en/language operators.xml 
  Log:
  grammar
  
http://cvs.php.net/diff.php/phpdoc/en/language/operators.xml?r1=1.78&r2=1.79&ty=u
Index: phpdoc/en/language/operators.xml
diff -u phpdoc/en/language/operators.xml:1.78 phpdoc/en/language/operators.xml:1.79
--- phpdoc/en/language/operators.xml:1.78   Fri Aug  6 15:13:20 2004
+++ phpdoc/en/language/operators.xmlFri Aug  6 15:26:12 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Operators
   
@@ -462,10 +462,10 @@
 


-If you compare integer with the string, the string is
-converted to number.
+If you compare an integer with a string, the string is
+converted to a number.
 If you compare two numerical strings, they are compared as integers. These
-rules are valid also for the
+rules also apply to the
 switch statement.
 
  


Re: [PHP-DOC] cvs: phpdoc /en/install/windows installer.xml manual.xml

2004-08-06 Thread Gabor Hojtsy
philip  Fri Aug  6 15:10:40 2004 EDT
  Modified files:  
/phpdoc/en/install/windows	installer.xml manual.xml 
  Log:
  A fairly major update.
Quite a general commit message for such a big commit. What was in? 
Language/grammar fixes?

Goba


[PHP-DOC] #23110 [Opn->Csd]: Ugly behaviour of == (and ===)

2004-08-06 Thread vrana
 ID:   23110
 Updated by:   [EMAIL PROTECTED]
 Reported By:  kyrael at web dot de
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: Linux
 PHP Version:  4.3.1
 New Comment:

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

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

"If you compare integer with the string, the string is converted to
number. If you compare two numerical strings, they are compared as
integers. These rules are valid also for the switch statement." +
example:

 true
var_dump("1" == "01"); // 1 == 1 -> true

switch ("a") {
case 0:
echo "0";
break;
case "a": // never reached because "a" is already matched with 0
echo "a";
break;
}
?>



Previous Comments:


[2004-05-22 11:20:55] [EMAIL PROTECTED]

See also #20726.



[2004-02-04 18:15:12] tgrey at supercomputerinc dot com

highly illogical indeed.  if the types differ, how could the values be
considered equal?  when working with functions that could have
different input types this behaviour is disasterous.  it seems to be
counterproductive to loose variable types, since a data type check has
to be added.

working around is often possible, but if i wanted to code around my ***
to get to my elbow i'd be using perl.  imho this behavior needs some
strong reconsideration.

very simple example:


or worse yet:




[2003-05-02 13:10:29] [EMAIL PROTECTED]

This will not change, the documentation team needs to be clear on
that.

We don't have '===' for nothing.



[2003-04-08 06:57:38] kyrael at web dot de

Btw, in switch you can't use strcmp or ===, because switch seems to use
==.



[2003-04-08 06:43:46] kyrael at web dot de


string(3) "1e1"
string(2) "10"
bool(true)
bool(false)

This behaviour is ugly - both operands are strings, and they are
clearly not equal. '1e0' and '1.0' and '1' are "equal" too. Same with
'3.20' and '3.2'. Does PHP think i am stupid and unable to type numbers
when i want them?
According to the manual, == returns true if the two operands are equal,
and === returns true if the operands are equal and of the same type. ==
says they are equal, and according to var_dump they are both strings -
why doesn't === return true then? So this behaviour is neither logical
nor documented. String comparison, even with == when both operands are
strings, should return 'equal' if and only if the strings are really
equal. Wouldn't be PHP5 a chance to change this?




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


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

2004-08-06 Thread Jakub Vrana
vrana   Fri Aug  6 15:13:20 2004 EDT

  Modified files:  
/phpdoc/en/language operators.xml 
  Log:
  Comparison of numerical strings (bug #23110)
  
http://cvs.php.net/diff.php/phpdoc/en/language/operators.xml?r1=1.77&r2=1.78&ty=u
Index: phpdoc/en/language/operators.xml
diff -u phpdoc/en/language/operators.xml:1.77 phpdoc/en/language/operators.xml:1.78
--- phpdoc/en/language/operators.xml:1.77   Mon Aug  2 06:54:00 2004
+++ phpdoc/en/language/operators.xmlFri Aug  6 15:13:20 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Operators
   
@@ -461,6 +461,32 @@
  
 

+   
+If you compare integer with the string, the string is
+converted to number.
+If you compare two numerical strings, they are compared as integers. These
+rules are valid also for the
+switch statement.
+
+ 
+
+ 
+ 
+   

 Another conditional operator is the "?:" (or ternary) operator.
 


[PHP-DOC] cvs: phpdoc /en/install/windows installer.xml manual.xml

2004-08-06 Thread Philip Olson
philip  Fri Aug  6 15:10:40 2004 EDT

  Modified files:  
/phpdoc/en/install/windows  installer.xml manual.xml 
  Log:
  A fairly major update.
  
  http://cvs.php.net/diff.php/phpdoc/en/install/windows/installer.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc/en/install/windows/installer.xml
diff -u phpdoc/en/install/windows/installer.xml:1.3 
phpdoc/en/install/windows/installer.xml:1.4
--- phpdoc/en/install/windows/installer.xml:1.3 Fri Jul 30 12:26:08 2004
+++ phpdoc/en/install/windows/installer.xml Fri Aug  6 15:10:40 2004
@@ -1,27 +1,28 @@
 
-
+

 Windows Installer
 
 
  The Windows PHP installer is available from the downloads page at
  &url.php.downloads;. This
- installs the CGI version of PHP
- and, for IIS, PWS, and Xitami, configures the web server as well.
+ installs the CGI version of PHP and for IIS, PWS,
+ and Xitami, it configures the web server as well.  The installer does not 
+ include any extra external PHP extensions (php_*.dll) as you'll only find 
+ those in the Windows Zip Package and PECL downloads.
 
 
  
-  While the windows installer is an easy way to make
-  PHP work, it is restricted in many aspects, as
-  automatic setup of extensions for example is not supported. The whole set
-  of supported extensions is only available by downloading the zip binary
-  distribution.
+  While the Windows installer is an easy way to make PHP work, it is 
+  restricted in many aspects as, for example, the automatic setup of 
+  extensions is not supported.  Use of the installer isn't the preferred 
+  method for installing PHP.
  
 
 
 
- Install your selected HTTP server on your system and
- make sure that it works.
+ First, install your selected HTTP (web) server on your 
+ system, and make sure that it works.
 
 
 
@@ -33,14 +34,16 @@
 
 
  The installation wizard gathers enough information to set up the &php.ini;
- file and configure the web server to use PHP. For IIS and also PWS on NT
- Workstation, a list of all the nodes on the server with script map settings
- is displayed, and you can choose those nodes to which you wish to add the
- PHP script mappings.
+ file, and configure certain web servers to use PHP.  With IIS or PWS on 
+ a NT Workstation, a list of all the nodes on the server with script map 
+ settings is displayed, and you can choose those nodes to which you wish 
+ to add the PHP script mappings.  One of the web servers the PHP installer 
+ does not configure for is Apache, so you'll need to configure it
+ manually.
 
 
 
- Once the installation has completed the installer will inform you if you
+ Once the installation has completed, the installer will inform you if you
  need to restart your system, restart the server, or just start using PHP.
 
 
http://cvs.php.net/diff.php/phpdoc/en/install/windows/manual.xml?r1=1.11&r2=1.12&ty=u
Index: phpdoc/en/install/windows/manual.xml
diff -u phpdoc/en/install/windows/manual.xml:1.11 
phpdoc/en/install/windows/manual.xml:1.12
--- phpdoc/en/install/windows/manual.xml:1.11   Thu Aug  5 08:53:24 2004
+++ phpdoc/en/install/windows/manual.xmlFri Aug  6 15:10:40 2004
@@ -1,32 +1,37 @@
 
-
+

 Manual Installation Steps
 
 
- This install guide will help you manually install and configure PHP on your
- Microsoft Windows webserver. You need to download the zip binary distribution
- from the downloads page at
- &url.php.downloads; to get started. 
+ This install guide will help you manually install and configure PHP with
+ a web server on Microsoft Windows.  To get started you'll need to download 
+ the zip binary distribution from the downloads page at
+ &url.php.downloads;.
 
 
 
- Although there are all-in-one installation kits and we also distribute an
- installer for Microsoft Windows, we recommend you to take some time and set
- up PHP yourself, since this provides better understanding of the system, and
- enables you to install PHP extensions easily whenever you need.
+ Although there are many all-in-one installation kits, and we also 
+ distribute a PHP installer for Microsoft Windows, we recommend you take 
+ the time to setup PHP yourself as this will provide you with a better 
+ understanding of the system, and enables you to install PHP extensions 
+ easily when needed.
 
 
 
  Upgrading from a previous PHP version
  
-  Previous editions of this manual suggested that you move ini files and DLLs
-  around your folders, and thus you might have PHP related files in multiple
-  folders on your hard drive. We advise you to remove all these files (php.ini
-  from the Windows folder, PHP related DLLs from the Windows system folder),
-  before going on with the 

Re: [PHP-DOC] time to switch the install section?

2004-08-06 Thread Gabor Hojtsy
Hi,
I've commit the activescript install instructions.
I think now we could switch to the new installation section, as it is much
more up-to-date than the old/current section.
If noone objects, I'll upgrade the manual.xml.in,
scripts/file-entities.php.in, and remove the files in the chapter dir.
I would like to see the turnover, but the file removal is not needed for 
the build to properly pick up the new files. Leaving the files might 
only confuse people later (and some translations would even start to 
translate it), so it is probably not a good idea to keep the old install 
files. So I would vote for the switch and the removal of files. Those 
who need it, will be able to find them in the attic.

Goba


Re: [PHP-DOC] cvs: phpdoc /en/install ini.xml /en/install/windows activescript.xml index.xml

2004-08-06 Thread Gabor Hojtsy
http://cvs.php.net/co.php/phpdoc/en/install/windows/activescript.xml?r=1.1&p=1
Index: phpdoc/en/install/windows/activescript.xml
+++ phpdoc/en/install/windows/activescript.xml


   
ActiveScript

 This section contains notes specific to the ActiveScript installation.

There needs to be a few sentences on what ActiveScript is, and what does 
the PHP activescript SAPI allow you. Also that it also only works on 
Windows, and there is no point in searching for that in the Linux part :)

 To test if ActiveScript is working, create a new file, named
 test.wsf (the extension is very important) and type:
 

 
 If you receive a little window saying "Hello World!" you're done.
You need to run it (by double clicking?), so it produces the output! :)
Goba


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

2004-08-06 Thread Philip Olson
philip  Fri Aug  6 12:58:59 2004 EDT

  Modified files:  
/phpdoc/en/install/windows  extensions.xml 
  Log:
  Removed php3_ extensions.
  
  
http://cvs.php.net/diff.php/phpdoc/en/install/windows/extensions.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc/en/install/windows/extensions.xml
diff -u phpdoc/en/install/windows/extensions.xml:1.2 
phpdoc/en/install/windows/extensions.xml:1.3
--- phpdoc/en/install/windows/extensions.xml:1.2Fri Jun  4 06:30:07 2004
+++ phpdoc/en/install/windows/extensions.xmlFri Aug  6 12:58:59 2004
@@ -1,5 +1,5 @@
 
-
+

 Installation of extensions on Windows
 
@@ -10,9 +10,7 @@
  dl.
 
 
- The DLLs for PHP extensions are prefixed with 'php_' in PHP 4 (and 
- 'php3_' in PHP 3). This prevents confusion between PHP extensions 
- and their supporting libraries. 
+ The DLLs for PHP extensions are prefixed with php_.
 
 
  
@@ -130,11 +128,6 @@
None
   
   
-   php3_crypt.dll
-   Crypt functions
-   unknown
-  
-  
php_ctype.dll
ctype family functions
Built in since PHP 4.3.0
@@ -167,11 +160,6 @@
None
   
   
-   php3_dbm.dll
-   Berkeley DB2 library
-   unknown
-  
-  
php_dbx.dll
dbx functions

@@ -260,7 +248,7 @@
   
php_imap.dll
IMAP POP3 and NNTP functions
-   PHP 3: php3_imap4r1.dll
+   None
   
   
php_ingres.dll
@@ -317,34 +305,9 @@
Requires: msql.dll (bundled)
   
   
-   php3_msql1.dll
-   mSQL 1 client
-   unknown
-  
-  
-   php3_msql2.dll
-   mSQL 2 client
-   unknown
-  
-  
php_mssql.dll
MSSQL functions
Requires: ntwdblib.dll (bundled)
-  
-  
-   php3_mysql.dll
-   MySQL functions
-   Built-in in PHP 4
-  
-  
-   php3_nsmail.dll
-   Netscape mail functions
-   unknown
-  
-  
-   php3_oci73.dll
-   Oracle functions
-   unknown
   
   
php_oci8.dll


[PHP-DOC] Re: arabic docbuilds

2004-08-06 Thread Salah Faya
Thanks for your attention about the ar builds, I thought it was broken 
because the translation is not complete yet.

Is there any clues that helps how to fix it? me and my team will do our best 
but we have no idea about DSSSL rendering anyway.

Regards,
Salah Faya
It's still broken, I'll have to dive into this a bit more.
See: http://www.php.net/manual/ar/
This is why it's broken:
cp -r ./../ZendAPI/figures ./php
/usr/local/bin/php -q ./scripts/phpweb-entities.php `pwd` phpweb
creating /home/derick/phpdoc-all/entities/phpweb.ent...
/usr/local/bin/php -q ./scripts/rtlpatch/hackmanuallang.php ar
SP_ENCODING=ISO-8859-6 /usr/bin/openjade -D . -wno-idref -c 
./entities/ISO/catalog -c ./dsssl/docbook/catalog -c 
./dsssl/defaults/catalog -d dsssl/phpweb.dsl -V use-output-dir -t
sgml ./dtds/dbxml-4.1.2/phpdocxml.dcl manual.xml
/usr/bin/openjade:././dsssl/docbook/html/../common/dbl10n.dsl:275:10:E: 
L10N ERROR: generate-toc-in-front
/usr/bin/openjade:././dsssl/docbook/html/../common/dbl10n.dsl:321:12:E: 
L10N ERROR: gentext-element-name: ar (toc)
/usr/bin/openjade:././dsssl/docbook/html/../common/dbl10n.dsl:417:12:E: 
L10N ERROR: gentext-intra-label-sep
/usr/bin/openjade:././dsssl/docbook/html/../common/dbl10n.dsl:417:12:E: 
L10N ERROR: gentext-intra-label-sep
/usr/bin/openjade:././dsssl/docbook/html/../common/dbl10n.dsl:417:12:E: 
L10N ERROR: gentext-intra-label-sep
/usr/bin/openjade:././dsssl/docbook/html/../common/dbl10n.dsl:321:12:E: 
L10N ERROR: gentext-element-name: ar (toc)
/usr/bin/openjade:././dsssl/docbook/html/../common/dbl10n.dsl:371:12:E: 
L10N ERROR: gentext-element-name-space
/usr/bin/openjade:././dsssl/docbook/html/../common/dbl10n.dsl:417:12:E: 
L10N ERROR: gentext-intra-label-sep
/usr/bin/openjade:././dsssl/docbook/html/../common/dbl10n.dsl:463:12:E: 
L10N ERROR: gentext-label-title-sep
/usr/bin/openjade:././dsssl/docbook/html/../common/dbl10n.dsl:417:12:E: 
L10N ERROR: gentext-intra-label-sep
Hm, this means that the DSSSL sheets are buggy, but updating them might 
lead to our customizations being lost, so it needs special attention once 
done by someone. Might not be needed at all, if livedocs goes gold soon :))

Goba


[PHP-DOC] #28414 [Opn]: [de] decimals in float

2004-08-06 Thread dave
 ID:   28414
 Updated by:   [EMAIL PROTECTED]
-Summary:  decimals in float
 Reported By:  udo dot steinbach at ewetel dot net
 Status:   Open
 Bug Type: Documentation problem
 Operating System: Windows
 PHP Version:  4.3.6
 New Comment:

Updating the summary so people can easily see it's a German doc
problem.


Previous Comments:


[2004-05-18 16:41:24] [EMAIL PROTECTED]

It's a bug in the german docs...



[2004-05-18 16:37:44] [EMAIL PROTECTED]

Write in english, please!



[2004-05-16 12:57:11] udo dot steinbach at ewetel dot net

Description:

My english is to bad, so in german.

In /de/language.types.float.html heißt es
> Das gründet sich auf die Tatsache, dass es unmöglich ist, manche
Dezimal-Zahlen durch eine endliche Anzahl an Nachkomma-Stellen
darzustellen

Das ist zwar richtig, aber die falsche Erklärung für den Satz davor
> So wird floor((0.1 + 0.7) * 10) normalerweise 7

Siehe news:[EMAIL PROTECTED] und
news:[EMAIL PROTECTED]
> Die Basis 10 ist inkommensurabelk mit der Basis 2. Auf binaer
arbeitenden Gleitkommahardwares wird daher (change - dollar_amount) =
1/10 auf der Hardware nicht exakt darstellbar sein, sondern so etwas
wie 0.0999… sein.  Damit ist int(100*...)=9.

Reproduce code:
---
?? for docs?

Expected result:

?? for docs?

Actual result:
--
?? for docs?





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


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

2004-08-06 Thread Philip Olson
philip  Fri Aug  6 12:23:17 2004 EDT

  Modified files:  
/phpdoc/en/reference/strings/functions  levenshtein.xml 
  Log:
  The third callback parameter has yet to be implemented so it's documentation is now 
commented out.
  See bug #29552 for a feature request to implement this feature. 
  Thanks to Dave for pointing this out. 
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/levenshtein.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc/en/reference/strings/functions/levenshtein.xml
diff -u phpdoc/en/reference/strings/functions/levenshtein.xml:1.2 
phpdoc/en/reference/strings/functions/levenshtein.xml:1.3
--- phpdoc/en/reference/strings/functions/levenshtein.xml:1.2   Wed Apr 17 02:44:16 
2002
+++ phpdoc/en/reference/strings/functions/levenshtein.xml   Fri Aug  6 12:23:17 
2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -23,12 +23,14 @@
   intcost_rep
   intcost_del
  
+ 
 
  This function returns the Levenshtein-Distance between the
  two argument strings or -1, if one of the argument strings
@@ -59,6 +61,7 @@
  is more general and adaptive than variant one, but not as
  efficient.
 
+
 
  See also soundex,
  similar_text, and


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

2004-08-06 Thread Aidan Lister
aidan   Fri Aug  6 11:45:56 2004 EDT

  Modified files:  
/phpdoc/en/reference/strings/functions  similar-text.xml 
  Log:
  Added soundex as well!
  
http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/similar-text.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc/en/reference/strings/functions/similar-text.xml
diff -u phpdoc/en/reference/strings/functions/similar-text.xml:1.4 
phpdoc/en/reference/strings/functions/similar-text.xml:1.5
--- phpdoc/en/reference/strings/functions/similar-text.xml:1.4  Fri Aug  6 11:44:07 
2004
+++ phpdoc/en/reference/strings/functions/similar-text.xml  Fri Aug  6 11:45:56 
2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -31,7 +31,7 @@
  both strings.
 
 
- See also levenshtein.
+ See also levenshtein, and soundex.
 

   


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

2004-08-06 Thread Aidan Lister
aidan   Fri Aug  6 11:44:07 2004 EDT

  Modified files:  
/phpdoc/en/reference/strings/functions  similar-text.xml 
  Log:
  Added seealso
  
http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/similar-text.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc/en/reference/strings/functions/similar-text.xml
diff -u phpdoc/en/reference/strings/functions/similar-text.xml:1.3 
phpdoc/en/reference/strings/functions/similar-text.xml:1.4
--- phpdoc/en/reference/strings/functions/similar-text.xml:1.3  Tue Aug  3 11:51:10 
2004
+++ phpdoc/en/reference/strings/functions/similar-text.xml  Fri Aug  6 11:44:07 
2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -30,6 +30,9 @@
  in percent for you. It returns the number of matching chars in
  both strings.
 
+
+ See also levenshtein.
+

   
 


[PHP-DOC] #24749 [Opn->Csd]: Installation problem with workaround

2004-08-06 Thread nlopess
 ID:   24749
 Updated by:   [EMAIL PROTECTED]
 Reported By:  michael at insitesinc dot com
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: winXP Pro
 PHP Version:  5.0.0b1 (beta1)
 New Comment:

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

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




Previous Comments:


[2003-11-30 04:38:39] mgturland at yahoo dot com

OK, OK, I know, I'm flooding the comments section. Sorry... here's an
update...

If iconv.dll is not copied to the sapi subdirectory, Apache generates
an error. If it is not copied to the root PHP directory, the PHP
interpretter generates an error when run with "php.exe -i". If it
copied to both locations, neither generates an error.

However, I'm still having trouble getting Apache to process my PHP
scripts. I've added the necessary lines specified in install.txt to
httpd.conf, and the web server is still outputting the source of the
scripts.

php.ini is located in my Windows directory. php4apache.dll and
php4ts.dll are in the sapi subdirectory. I even tried copying php.exe
to the sapi subdirectory, in attempt to make it accessible to the web
server as install.txt suggested, but that didn't seem to have any
effect.



[2003-11-30 04:24:45] mgturland at yahoo dot com

Sorry, correction to my last post. This post...

[22 Jul 2:11am EDT] michael at insitesinc dot com 

... is correct. Copying iconv.dll to the root PHP directory will get
rid of the error message "php.exe -i" generates, but it will not get
rid of the error message Apache generates.



[2003-11-30 04:21:04] mgturland at yahoo dot com

Same problem, running on Windows XP Pro with Apache 1.3.29 and PHP
5.0b2. I tried running "php.exe -i" as install.txt recommended, and got
this error:

php.exe - Unable to Locate Component
This application has failed to start because iconv.dll was not found.
Re-installing the application may fix this problem.

Once I copied iconv.dll to the root PHP directory, it seemed to work
without any problem.



[2003-07-22 02:11:22] michael at insitesinc dot com

this isnt a copy to system32 and problems over situation because many
of us like to run multiple installations of php and have to
compartmentalize the installations ensuring that no dll's are
improperly used by a wrong version.



[2003-07-22 02:06:30] michael at insitesinc dot com

Description:

Ok this gets pretty close to the "dont submit this bug issue" above but
is not related to the name change of the php module. 

When you attempt to install and configure php5.0b1+ (maybe others
below) to run as module of apache 2.0.47 you now must copy the file
iconv.dll into either the sapi directory (in addition to php4ts.dll as
well) or into another acceptable location (mentioned in regards to the
thread safe dll in install.txt). Im fairly certain that this isnt an
intended requirement but not sure if it my problem (although i have
heard many others complain as well).
If you fail to copy this dll to one of the three directories apache
will produce an error on start up which says "Cannot load
C:/pathto/php5/sapi/php4apache2.dll"






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


[PHP-DOC] #24970 [Opn->Csd]: install.windows.php: tell users to change path, not file locations

2004-08-06 Thread nlopess
 ID:   24970
 Updated by:   [EMAIL PROTECTED]
 Reported By:  danielc at analysisandsolutions dot com
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: Windows
 PHP Version:  Irrelevant
 New Comment:

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

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




Previous Comments:


[2003-08-07 02:30:08] danielc at analysisandsolutions dot com

Changed Summary.



[2003-08-07 02:26:36] danielc at analysisandsolutions dot com

Description:

Hi Folks:

I would like to strongly urge install.windows.php be changed in regards
to how DLL's and paths are handled.

The current recommendations say users should move the various needed
DLLs into a location that's within the path, like c:\winnt\system32.

This is cumbersome and prone to error, particularly when upgrading.

The FAR simpler solution is to change the path itself.  All one needs
to do is add ";c:\php;c:\php\dlls" to the end of one's path statement
and you're good to go!

Now, one can switch between PHP versions just by moving the old
installation into a different directory and unziping the new version
into c:\php.

This is what I've done on my system and it works great.

Thanks,

--Dan






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


[PHP-DOC] time to switch the install section?

2004-08-06 Thread Nuno Lopes
Hello,

I've commit the activescript install instructions.

I think now we could switch to the new installation section, as it is much
more up-to-date than the old/current section.

If noone objects, I'll upgrade the manual.xml.in,
scripts/file-entities.php.in, and remove the files in the chapter dir.


Nuno


[PHP-DOC] cvs: phpdoc /en/install/windows activescript.xml

2004-08-06 Thread Jakub Vrana
vrana   Fri Aug  6 11:16:01 2004 EDT

  Modified files:  
/phpdoc/en/install/windows  activescript.xml 
  Log:
  Typo
  
http://cvs.php.net/diff.php/phpdoc/en/install/windows/activescript.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc/en/install/windows/activescript.xml
diff -u phpdoc/en/install/windows/activescript.xml:1.2 
phpdoc/en/install/windows/activescript.xml:1.3
--- phpdoc/en/install/windows/activescript.xml:1.2  Fri Aug  6 11:12:23 2004
+++ phpdoc/en/install/windows/activescript.xml  Fri Aug  6 11:16:01 2004
@@ -1,5 +1,5 @@
 
-
+

 ActiveScript
 
@@ -45,7 +45,7 @@
 
 
  
-  ActiveScript doens't use the default &php.ini; file. Instead, it will
+  ActiveScript doesn't use the default &php.ini; file. Instead, it will
   look only in the same directory as the .exe that caused it to load. You
   should create php-activescript.ini and place it in
   that folder, if you wish to load extensions, etc.


[PHP-DOC] cvs: phpdoc /en/install/windows activescript.xml

2004-08-06 Thread Nuno Lopes
nlopess Fri Aug  6 11:12:23 2004 EDT

  Modified files:  
/phpdoc/en/install/windows  activescript.xml 
  Log:
  ups, copy-paste error...
  
http://cvs.php.net/diff.php/phpdoc/en/install/windows/activescript.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/install/windows/activescript.xml
diff -u phpdoc/en/install/windows/activescript.xml:1.1 
phpdoc/en/install/windows/activescript.xml:1.2
--- phpdoc/en/install/windows/activescript.xml:1.1  Fri Aug  6 11:09:50 2004
+++ phpdoc/en/install/windows/activescript.xml  Fri Aug  6 11:12:23 2004
@@ -1,5 +1,5 @@
 
-
+

 ActiveScript
 
@@ -30,7 +30,7 @@
 
  To test if ActiveScript is working, create a new file, named
  test.wsf (the extension is very important) and type:
- 
+ 
 

[PHP-DOC] cvs: phpdoc /en/install ini.xml /en/install/windows activescript.xml index.xml

2004-08-06 Thread Nuno Lopes
nlopess Fri Aug  6 11:09:50 2004 EDT

  Added files: 
/phpdoc/en/install/windows  activescript.xml 

  Modified files:  
/phpdoc/en/install  ini.xml 
/phpdoc/en/install/windows  index.xml 
  Log:
  add activescript
  
http://cvs.php.net/diff.php/phpdoc/en/install/ini.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/install/ini.xml
diff -u phpdoc/en/install/ini.xml:1.1 phpdoc/en/install/ini.xml:1.2
--- phpdoc/en/install/ini.xml:1.1   Tue Jun  8 17:47:58 2004
+++ phpdoc/en/install/ini.xml   Fri Aug  6 11:09:50 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Runtime Configuration
 
@@ -23,6 +23,11 @@
 linkend="features.commandline">command line. You can also use the
 environment variable PHPRC for an additional path to
 search for a &php.ini; file.
+   
+   
+If php-SAPI.ini exists (where SAPI is used SAPI, so the
+filename is e.g. php-cli.ini or
+php-apache.ini), it's used instead of &php.ini;.


 
http://cvs.php.net/diff.php/phpdoc/en/install/windows/index.xml?r1=1.11&r2=1.12&ty=u
Index: phpdoc/en/install/windows/index.xml
diff -u phpdoc/en/install/windows/index.xml:1.11 
phpdoc/en/install/windows/index.xml:1.12
--- phpdoc/en/install/windows/index.xml:1.11Thu Aug  5 08:33:12 2004
+++ phpdoc/en/install/windows/index.xml Fri Aug  6 11:09:50 2004
@@ -1,5 +1,5 @@
 
-
+
   
Installation on Windows systems

@@ -33,6 +33,7 @@

&install.windows.installer;
&install.windows.manual;
+   &install.windows.activescript;
&install.windows.iis;
&install.windows.apache1;
&install.windows.apache2;

http://cvs.php.net/co.php/phpdoc/en/install/windows/activescript.xml?r=1.1&p=1
Index: phpdoc/en/install/windows/activescript.xml
+++ phpdoc/en/install/windows/activescript.xml


   
ActiveScript

 This section contains notes specific to the ActiveScript installation.


 As of PHP 5.0.1, ActiveScript has been moved to the PECL repository. &pecl.windows.download;


 
  You should read the manual
   installation steps first!
 


 After installing PHP, you should download the ActiveScript DLL
 (php5activescript.dll) and place it in the main PHP
 folder (e.g. C:\php).


 After having all the files needed, you must register the DLL on your
 system. To achieve this, open a Command Prompt window (located in the
 Start Menu). Then go to your PHP directory by typing something like
 cd C:\php. To register the DLL just type
 regsvr32 php5activescript.dll.


 To test if ActiveScript is working, create a new file, named
 test.wsf (the extension is very important) and type:
 

 
 If you receive a little window saying "Hello World!" you're done.


 
  ActiveScript doens't use the default &php.ini; file. Instead, it will
  look only in the same directory as the .exe that caused it to load. You
  should create php-activescript.ini and place it in
  that folder, if you wish to load extensions, etc.
 

   




[PHP-DOC] #28683 [Opn->Csd]: addcslashes ASCII character conversion octal range invalid

2004-08-06 Thread dave
 ID:   28683
 Updated by:   [EMAIL PROTECTED]
 Reported By:  todd at magnifisites dot com
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: RH Linux/Windows XP
 PHP Version:  4.3.6
 New Comment:

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

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

I only saw one error in the documentation and have fixed it. Remember
that octal representation is base 8, not base 10. \36 is not the '$'
character, it is ASCII character 30, which is why your expected result
and all its \ are wrong.


Previous Comments:


[2004-06-07 21:53:51] todd at magnifisites dot com

Description:

The addcslashes manual page states that characters with ASCII code
lower than 32 and higher than 126 are converted to octal
representation.  It then instructs us to use the ord() function to find
the ASCII value for a character.  I have found discrepancies in my tests
(I've tested on both Linux and Windows servers).  The octal
representation conversion seems to occur completely throughout the
range including 32 through 126, inclusive, rather than outside that
range.

Reproduce code:
---
$null = NULL;
$var = "Hi there\" dollar $ amper \t sand & and single ' quote NULL
$null";
$escaped_var = addcslashes($var, "\0\9\34\36\38\39");
print $escaped_var;


Expected result:

Hi there\" dollar \$ amper \t sand \& and single \' quote NULL


Actual result:
--
Hi there" dollar $ amper sand & and single ' quote NULL





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


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

2004-08-06 Thread Dave Barr
daveFri Aug  6 11:00:08 2004 EDT

  Modified files:  
/phpdoc/en/reference/strings/functions  addcslashes.xml 
  Log:
  - Fix #28683.
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/addcslashes.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc/en/reference/strings/functions/addcslashes.xml
diff -u phpdoc/en/reference/strings/functions/addcslashes.xml:1.5 
phpdoc/en/reference/strings/functions/addcslashes.xml:1.6
--- phpdoc/en/reference/strings/functions/addcslashes.xml:1.5   Sat Nov 22 14:31:43 
2003
+++ phpdoc/en/reference/strings/functions/addcslashes.xml   Fri Aug  6 11:00:08 
2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -30,7 +30,7 @@
 
 
  charlist like "\0..\37", which would
- escape all characters with ASCII code between 0 and 37.
+ escape all characters with ASCII code between 0 and 31.
  
   addcslashes example
   


[PHP-DOC] #25186 [Opn->Csd]: php_uname - not the build os, but the running os

2004-08-06 Thread dave
 ID:  25186
 Updated by:  [EMAIL PROTECTED]
 Reported By: [EMAIL PROTECTED]
-Status:  Open
+Status:  Closed
 Bug Type:Documentation problem
 PHP Version: Irrelevant
 New Comment:

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

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

After almost a year, I have fixed this. See
http://cvs.php.net/diff.php/phpdoc/en/reference/info/functions/php-uname.xml?r1=1.9&r2=1.10&ty=h


Previous Comments:


[2003-08-21 05:49:15] [EMAIL PROTECTED]

sorry, I need some coffee.. :)
forget what I've said



[2003-08-21 05:45:52] [EMAIL PROTECTED]

Please don't report bugs for the notes in the manual. 
See http://www.php.net/manual/en/about.notes.php

you can send us a mail at [EMAIL PROTECTED] if you want us to
remove some notes.

cheers,

didou



[2003-08-21 05:42:22] daveb at optusnet dot com dot au

To me it looks like:

On Windows, it's always the running OS.

On *nix, it's the running OS except when the call to uname() fails or
when  doesn't exist, then it falls back to the build
OS.

As for the PHP_OS constant, it seems to always be the build OS.

So the documentation appears to needs work.



[2003-08-21 05:26:18] [EMAIL PROTECTED]

Description:

Is this note correct?

vbhackattack at hotmail dot com 24-Mar-2003 05:17

According to the source code for this function (/ext/standard/info.c),
the description is not correct. The function returns information about
the operating system PHP is _running_ on, not built on. For example, if
PHP was build on Win2000 but is running on WinXP, the function should
report a version number appropriate for WinXP. I have not tested this,
just read the source code which calls the WinAPI function GetVersion()
or the *nix function uname() at _run_ time.

John







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


[PHP-DOC] cvs: phpdoc /en/reference/info/functions php-uname.xml

2004-08-06 Thread Dave
daveFri Aug  6 09:01:28 2004 EDT

  Modified files:  
/phpdoc/en/reference/info/functions php-uname.xml 
  Log:
  - Completely redo php_uname(). Fixes #25186 too.
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/info/functions/php-uname.xml?r1=1.9&r2=1.10&ty=u
Index: phpdoc/en/reference/info/functions/php-uname.xml
diff -u phpdoc/en/reference/info/functions/php-uname.xml:1.9 
phpdoc/en/reference/info/functions/php-uname.xml:1.10
--- phpdoc/en/reference/info/functions/php-uname.xml:1.9Thu Jan 15 10:02:50 
2004
+++ phpdoc/en/reference/info/functions/php-uname.xmlFri Aug  6 09:01:28 2004
@@ -1,25 +1,66 @@
 
-
+
 
   

 php_uname
 
- Returns information about the operating system PHP was built on
+ Returns information about the operating system PHP is running on
 


 Description
  
   stringphp_uname
-  
+  stringmode
  
-
- php_uname returns a string with a
- description of the operating system PHP is built on.  If you're just
- wanting the name of the operating system, consider using the
- PHP_OS constant.
-
+
+ php_uname returns a description of the operating
+ system PHP is running on. For the name of just the operating system,
+ consider using the PHP_OS constant, but be
+ reminded this constant will contain the operating system PHP was
+ built on.
+
+
+ On Unix, the output reverts to displaying the operating system
+ information PHP was built on if it cannot determine the currently
+ running OS.
+
+
+ mode defines what information is returned:
+ 
+  
+   
+'a': This is the default. Contains all modes in the 
sequence "s n r v m".
+   
+  
+  
+   
+'s': Operating system name. eg. FreeBSD.
+   
+  
+  
+   
+'n': Host name. eg. 
localhost.example.com.
+   
+  
+  
+   
+'r': Release name. eg. 5.1.2-RELEASE.
+   
+  
+  
+   
+'v': Version information. Varies a lot between operating 
systems.
+   
+  
+  
+   
+'m': Machine type. eg. i386.
+   
+  
+ 
+
 
  
   Some php_uname examples


Re: [PHP-DOC] Re: livedocs css patch

2004-08-06 Thread Gabor Hojtsy
It seems to be a funny issue with peoples fonts,
http://aidan.dotgeek.org/foo.gif
vs
http://files.derickrethans.nl/livedocs.png
Either way, shouldn't be fixed as it's not broken.
This patch now just removes a bit of css bloat
http://aidan.dotgeek.org/livedocs_css.diff
The display on my machine (Linux+Firefox) resembles Aidan's shots.
Goba


[PHP-DOC] cvs: phpdoc /en/language/oop5 reflection.xml

2004-08-06 Thread Nuno Lopes
nlopess Fri Aug  6 06:43:52 2004 EDT

  Modified files:  
/phpdoc/en/language/oop5reflection.xml 
  Log:
  document ReflectionParameter::isOptional()
  
http://cvs.php.net/diff.php/phpdoc/en/language/oop5/reflection.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc/en/language/oop5/reflection.xml
diff -u phpdoc/en/language/oop5/reflection.xml:1.1 
phpdoc/en/language/oop5/reflection.xml:1.2
--- phpdoc/en/language/oop5/reflection.xml:1.1  Sun Jul 11 08:33:25 2004
+++ phpdoc/en/language/oop5/reflection.xml  Fri Aug  6 06:43:52 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Reflection
   
@@ -221,11 +221,17 @@
   public ReflectionClass getClass()
   public bool allowsNull()
   public bool isPassedByReference()
+  public bool isOptional()
   }
 ?>
 ]]>
 

+   
+
+ isOptional was added in PHP 5.1.0.
+
+   

 To introspect function parameters, you will first have to create an instance
 of the ReflectionFunction or 
@@ -239,7 +245,7 @@
 getName(),
 var_export($param->getClass(), 1),
 var_export($param->allowsNull(), 1),
-var_export($param->isPassedByReference(), 1)
+var_export($param->isPassedByReference(), 1),
+$param->isOptional() ? 'yes' : 'no'
 );
 }
 ?>


[PHP-DOC] cvs: phpdoc /en/reference/network/functions ip2long.xml

2004-08-06 Thread Dave
daveFri Aug  6 06:04:49 2004 EDT

  Modified files:  
/phpdoc/en/reference/network/functions  ip2long.xml 
  Log:
  - Typo.
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/network/functions/ip2long.xml?r1=1.11&r2=1.12&ty=u
Index: phpdoc/en/reference/network/functions/ip2long.xml
diff -u phpdoc/en/reference/network/functions/ip2long.xml:1.11 
phpdoc/en/reference/network/functions/ip2long.xml:1.12
--- phpdoc/en/reference/network/functions/ip2long.xml:1.11  Fri Aug  6 06:04:01 
2004
+++ phpdoc/en/reference/network/functions/ip2long.xml   Fri Aug  6 06:04:49 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -94,7 +94,7 @@
 
 
  ip2long will also work with non-complete IP
- adresses. Read &url.ip2long.tech;
+ addresses. Read &url.ip2long.tech;
  for more info.
 
 


[PHP-DOC] #29545 [Opn->Csd]: array_pop() warning about FALSE

2004-08-06 Thread nlopess
 ID:   29545
 Updated by:   [EMAIL PROTECTED]
 Reported By:  kingoleg at mail dot ru
-Status:   Open
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: all
 PHP Version:  Irrelevant
 New Comment:

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

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


Previous Comments:


[2004-08-06 11:54:04] kingoleg at mail dot ru

Description:

I have found a "bug" on page function.array-pop.html

I read:

If array is empty (or is not an array), NULL will be returned. 

But there is a warning about FALSE:

This function may return Boolean FALSE, but may also return a
non-Boolean value which evaluates to FALSE, such as 0 or "". Please
read the section on Booleans for more information. Use the === operator
for testing the return value of this function.

So, I know, that this warning is exists in man of function that on
failure return (boolean)FALSE but can return (integer)0 that equal (in
== sense) to FALSE.

I think, that this warning is not needed on this page.

Reproduce code:
---
http://us2.php.net/manual/en/function.array-pop.php

Expected result:

There is no Warning about FALSE.

Actual result:
--
Warning about FALSE





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


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

2004-08-06 Thread Nuno Lopes
nlopess Fri Aug  6 06:04:18 2004 EDT

  Modified files:  
/phpdoc/en/reference/array/functionsarray-pop.xml 
  Log:
  fix #29545: remove bogus warning
  
http://cvs.php.net/diff.php/phpdoc/en/reference/array/functions/array-pop.xml?r1=1.9&r2=1.10&ty=u
Index: phpdoc/en/reference/array/functions/array-pop.xml
diff -u phpdoc/en/reference/array/functions/array-pop.xml:1.9 
phpdoc/en/reference/array/functions/array-pop.xml:1.10
--- phpdoc/en/reference/array/functions/array-pop.xml:1.9   Tue Aug  3 06:24:05 
2004
+++ phpdoc/en/reference/array/functions/array-pop.xml   Fri Aug  6 06:04:18 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -53,7 +53,6 @@
   
  
 
-&return.falseproblem;
 
  See also array_push,
  array_shift, and


[PHP-DOC] #25997 [Ana->Csd]: Embedded null characters in strings breaks documented behavior of functions.

2004-08-06 Thread dave
 ID:   25997
 Updated by:   [EMAIL PROTECTED]
 Reported By:  xodfull at starmen dot net
-Status:   Analyzed
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: Linux, Apache.
 PHP Version:  4.3.3
 New Comment:

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

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




Previous Comments:


[2003-10-27 17:29:54] [EMAIL PROTECTED]

ip2long() works as advertised. However, if brought a very good point
and this should be documented. For security, if ip2long() is used only
for validation the IP should be escaped or should be used like this:
$ip = long2ip(ip2long($ip));



[2003-10-26 22:32:27] xodfull at starmen dot net

Description:

ip2long() is supposed to return -1 on an invalid ip address.  Because
of PHP's method of storing strings, and a careless calling of standard
C library functions that use null-terminated strings, it will not
return -1 on invalid ip addresses that contain embedded null characters
in appropriate places.

" The function ip2long() generates an IPv4 Internet network address
from its Internet standard format (dotted string) representation. If
ip_address is invalid than -1 is returned. Note that -1  does not
evaluate as FALSE in PHP."

Reproduce code:
---
if(ip2long($_GET[ip]) != -1)
 echo($_GET[ip]);

http://something.net/somescript.php?ip=127.0.0.1%00foo

Expected result:

Arbitrary HTML insertion.  Worse effects may be possible depending on
the application.






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


[PHP-DOC] cvs: phpdoc /en/reference/network/functions ip2long.xml

2004-08-06 Thread Dave
daveFri Aug  6 06:04:01 2004 EDT

  Modified files:  
/phpdoc/en/reference/network/functions  ip2long.xml 
  Log:
  - Fix #25997.
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/network/functions/ip2long.xml?r1=1.10&r2=1.11&ty=u
Index: phpdoc/en/reference/network/functions/ip2long.xml
diff -u phpdoc/en/reference/network/functions/ip2long.xml:1.10 
phpdoc/en/reference/network/functions/ip2long.xml:1.11
--- phpdoc/en/reference/network/functions/ip2long.xml:1.10  Wed Aug  4 14:33:09 
2004
+++ phpdoc/en/reference/network/functions/ip2long.xml   Fri Aug  6 06:04:01 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -28,10 +28,9 @@
   ip_address is invalid.
  
 
-
- 
-  ip2long Example
-  
+
+ ip2long Example
+ 
 
-  
- 
-
+ 
+
 
  
   
@@ -56,9 +54,10 @@
 
  This second example shows how to print a converted address with the
  printf function in both PHP 4 and PHP 5:
- 
-  Displaying an IP address
-  
+
+
+ Displaying an IP address
+ 
 
-  
- 
+ 
+
+
+ ip2long should not be used as the sole form
+ of IP validation. Combine it with long2ip:
 
+
+ IP validation
+ 
+
+ 
+
 
- ip2long will also work with non-complete ip
+ ip2long will also work with non-complete IP
  adresses. Read &url.ip2long.tech;
  for more info.
 
 
  
   ip2long will return -1 for
-  the IP 255.255.255.255
+  the IP 255.255.255.255
  
 
 


[PHP-DOC] #29545 [NEW]: array_pop() warning about FALSE

2004-08-06 Thread kingoleg at mail dot ru
From: kingoleg at mail dot ru
Operating system: all
PHP version:  Irrelevant
PHP Bug Type: Documentation problem
Bug description:  array_pop() warning about FALSE

Description:

I have found a "bug" on page function.array-pop.html

I read:

If array is empty (or is not an array), NULL will be returned. 

But there is a warning about FALSE:

This function may return Boolean FALSE, but may also return a non-Boolean
value which evaluates to FALSE, such as 0 or "". Please read the section
on Booleans for more information. Use the === operator for testing the
return value of this function.

So, I know, that this warning is exists in man of function that on failure
return (boolean)FALSE but can return (integer)0 that equal (in == sense) to
FALSE.

I think, that this warning is not needed on this page.

Reproduce code:
---
http://us2.php.net/manual/en/function.array-pop.php

Expected result:

There is no Warning about FALSE.

Actual result:
--
Warning about FALSE

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


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

2004-08-06 Thread Jakub Vrana
vrana   Fri Aug  6 05:00:04 2004 EDT

  Modified files:  
/phpdoc/en/language references.xml 
  Log:
  WS
  
http://cvs.php.net/diff.php/phpdoc/en/language/references.xml?r1=1.32&r2=1.33&ty=u
Index: phpdoc/en/language/references.xml
diff -u phpdoc/en/language/references.xml:1.32 phpdoc/en/language/references.xml:1.33
--- phpdoc/en/language/references.xml:1.32  Thu Aug  5 11:05:59 2004
+++ phpdoc/en/language/references.xml   Fri Aug  6 05:00:04 2004
@@ -1,5 +1,5 @@
 
-
+
  
   References Explained
 
@@ -26,7 +26,7 @@
  
 
  
@@ -57,7 +57,7 @@
 
 
@@ -151,13 +151,13 @@
  
 
  
@@ -183,7 +183,7 @@
  
 
@@ -303,13 +303,13 @@
  
 
@@ -342,7 +342,7 @@
 
 ]]>
  


[PHP-DOC] cvs: phpdoc /en/language control-structures.xml

2004-08-06 Thread Jakub Vrana
vrana   Fri Aug  6 04:55:17 2004 EDT

  Modified files:  
/phpdoc/en/language control-structures.xml 
  Log:
  foreach &
  
http://cvs.php.net/diff.php/phpdoc/en/language/control-structures.xml?r1=1.102&r2=1.103&ty=u
Index: phpdoc/en/language/control-structures.xml
diff -u phpdoc/en/language/control-structures.xml:1.102 
phpdoc/en/language/control-structures.xml:1.103
--- phpdoc/en/language/control-structures.xml:1.102 Fri Aug  6 04:32:48 2004
+++ phpdoc/en/language/control-structures.xml   Fri Aug  6 04:55:17 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Control Structures
 
@@ -541,6 +541,27 @@
   is advanced with the processing of the
   array.  Assuming the foreach loop runs to completion, the
   array's internal pointer will be at the end of the array.
+ 
+ 
+  As of PHP 5, you can easily modify array's elements by preceding
+  $value with &. This will assign
+  reference instead of copying
+  the value.
+  
+   
+
+   
+  
+  This is possible only if iterated array can be referenced (i.e. is
+  variable).
  
 



[PHP-DOC] Re: livedocs css patch

2004-08-06 Thread Aidan Lister
It seems to be a funny issue with peoples fonts,

http://aidan.dotgeek.org/foo.gif
vs
http://files.derickrethans.nl/livedocs.png

Either way, shouldn't be fixed as it's not broken.

This patch now just removes a bit of css bloat
http://aidan.dotgeek.org/livedocs_css.diff


"Aidan Lister" <[EMAIL PROTECTED]> wrote in message
news:[EMAIL PROTECTED]
> Hello,
>
> I did a quick patch for the livedocs default theme:
>
> http://aidan.dotgeek.org/livedocs_css.diff
>
> It cleans up a bit of redudant code, and makes the method/class synopsis
> look nicer by dropping the func/class size.


[PHP-DOC] cvs: phpdoc /en/language control-structures.xml

2004-08-06 Thread Jakub Vrana
vrana   Fri Aug  6 04:32:49 2004 EDT

  Modified files:  
/phpdoc/en/language control-structures.xml 
  Log:
  WS
  
http://cvs.php.net/diff.php/phpdoc/en/language/control-structures.xml?r1=1.101&r2=1.102&ty=u
Index: phpdoc/en/language/control-structures.xml
diff -u phpdoc/en/language/control-structures.xml:1.101 
phpdoc/en/language/control-structures.xml:1.102
--- phpdoc/en/language/control-structures.xml:1.101 Tue Jul 27 17:17:22 2004
+++ phpdoc/en/language/control-structures.xml   Fri Aug  6 04:32:48 2004
@@ -1,5 +1,5 @@
 
-
+
  
   Control Structures
 
@@ -25,7 +25,7 @@
  
 
@@ -242,7 +242,8 @@
 
  
 
  
 
@@ -268,7 +269,10 @@
 
  
 
  
 
@@ -386,7 +390,8 @@
 
  
 
  
 
@@ -471,7 +476,10 @@
 
  
 
  
  
@@ -490,8 +498,10 @@
 
  
 
  
 
@@ -550,8 +560,8 @@
 
  
 
@@ -1071,11 +1082,11 @@
 // Return the times stored in profile, then erase it
 if ($dump) {
 $temp = $profile;
-unset ($profile);
-return ($temp);
+unset($profile);
+return($temp);
 }
 
-$profile[] = microtime ();
+$profile[] = microtime();
 }
 
 // Set up a tick handler
@@ -1092,7 +1103,7 @@
 }
 
 // Display the data stored in the profiler
-print_r(profile (TRUE));
+print_r(profile(TRUE));
 ?>
 ]]>
  


[PHP-DOC] cvs: phpdoc /en/reference/mysqli/functions mysqli-connect.xml

2004-08-06 Thread Aidan Lister
aidan   Fri Aug  6 03:21:50 2004 EDT

  Modified files:  
/phpdoc/en/reference/mysqli/functions   mysqli-connect.xml 
  Log:
  Removed a useless space - sorry!
  
http://cvs.php.net/diff.php/phpdoc/en/reference/mysqli/functions/mysqli-connect.xml?r1=1.15&r2=1.16&ty=u
Index: phpdoc/en/reference/mysqli/functions/mysqli-connect.xml
diff -u phpdoc/en/reference/mysqli/functions/mysqli-connect.xml:1.15 
phpdoc/en/reference/mysqli/functions/mysqli-connect.xml:1.16
--- phpdoc/en/reference/mysqli/functions/mysqli-connect.xml:1.15Tue Mar 16 
10:36:17 2004
+++ phpdoc/en/reference/mysqli/functions/mysqli-connect.xml Fri Aug  6 03:21:49 
2004
@@ -1,5 +1,5 @@
 
-
+
   

 mysqli_connect
@@ -36,7 +36,7 @@
  running on host which can be either a host name or an IP 
address. Passing the
  &null; value or the string "localhost" to this parameter, the local host is 
assumed. When possible, 
  pipes will be used instead of the TCP/IP protocol. If successful, the 
mysqli_connect
- will return an object  representing the connection to the database, or &false; 
on failure.
+ will return an object representing the connection to the database, or &false; on 
failure.
 
 
  The username and password 
parameters specify the


[PHP-DOC] #24185 [Ana->Csd]: getcwd() fails if parent directory miss readable-flag

2004-08-06 Thread dave
 ID:   24185
 Updated by:   [EMAIL PROTECTED]
 Reported By:  fulcrum at mbnet dot fi
-Status:   Analyzed
+Status:   Closed
 Bug Type: Documentation problem
 Operating System: NetBSD
 PHP Version:  4CVS-2003-06-14 (stable)
 New Comment:

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

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

This is the case on some unices, and is actually in the
POSIX 1 standard:

In section 5.2.2.4: For each of the following conditions, if
the condition is detected, the getcwd() function shall
return a value of NULL and set errno to the corresponding
value:

[EACCESS] Read or search permission was denied for a
component of the pathname.

So I've documented this and the fact that the return value can be
false.


Previous Comments:


[2003-06-14 17:30:54] [EMAIL PROTECTED]

At least Linux, OpenBSD, AIX, Solaris and HP-UX implementations of
getcwd() should behave the same way.
(I didn't test it, just read the man pages I found with google :)




[2003-06-14 15:14:45] fulcrum at mbnet dot fi

I have experienced on two servers, one Linux (unkown distro) server
running 4.3.1 and an other unkown UNIX (?) computer with the opposite
effect (the effect I was expecting myself). Could this be a OS specific
issue?

Anyways the documenation should be clarified.



[2003-06-14 13:44:59] [EMAIL PROTECTED]

>From "man getcwd":

RETURN VALUE
  NULL  on failure (for example, if the current directory
  is not readable), with errno set accordingly,
  and buf on success.

And as PHP just wraps around this function, the behaviour is the same.




[2003-06-14 12:44:28] fulcrum at mbnet dot fi

Description:

If one of the parent directories of the current working directory
doesn't have the readable flag +r (while +x is still specified)
getcwd() return false, even though the current directory has full (or
at least readable & executale) access (the restrictive permissions
apply ONLY to the parent directory).

The possible return value of false isn't either mentioned in the
documenation.

Reproduce code:
---
mkdir one ; mkdir one/two ; mkdir one/two/three
echo "" > one/sample.php
echo "" > one/two/sample.php
echo "" > one/two/three/sample.php
chmod 111 one ; chmod 755 one/two ; chmod 755 one/two/three
chmod 644 one/sample.php ; chmod 644 one/two/sample.php ; chmod 644
one/two/three/sample.php

Expected result:

one/sample.php:
string; true

one/two/sample.php:
string; true

one/two/three/sample.php:
string; true

Actual result:
--
one/sample.php:
string; true

one/two/sample.php:
boolean; false

one/two/three/sample.php:
boolean; false





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


[PHP-DOC] livedocs css patch

2004-08-06 Thread Aidan Lister
Hello,

I did a quick patch for the livedocs default theme:

http://aidan.dotgeek.org/livedocs_css.diff

It cleans up a bit of redudant code, and makes the method/class synopsis
look nicer by dropping the func/class size.


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

2004-08-06 Thread Dave
daveFri Aug  6 03:20:13 2004 EDT

  Modified files:  
/phpdoc/en/reference/dir/functions  getcwd.xml 
  Log:
  - Fix #24185.
  
  
http://cvs.php.net/diff.php/phpdoc/en/reference/dir/functions/getcwd.xml?r1=1.6&r2=1.7&ty=u
Index: phpdoc/en/reference/dir/functions/getcwd.xml
diff -u phpdoc/en/reference/dir/functions/getcwd.xml:1.6 
phpdoc/en/reference/dir/functions/getcwd.xml:1.7
--- phpdoc/en/reference/dir/functions/getcwd.xml:1.6Fri Jul 30 00:20:42 2004
+++ phpdoc/en/reference/dir/functions/getcwd.xmlFri Aug  6 03:20:12 2004
@@ -1,5 +1,5 @@
 
-
+
 
   

@@ -15,6 +15,15 @@
 
  Returns the current working directory, or &false; on failure.
 
+
+ 
+  On some Unix variants, getcwd will return
+  &false; if any one of the parent directories does not have the
+  readable or search mode set, even if the current directory
+  does. See chmod for more information on
+  modes and permissions.
+ 
+
 
  
   getcwd example
@@ -33,9 +42,7 @@
 ?>
 ]]>

-   
-This example will output something like:
-   
+   &example.outputs.similar;