[PHP-DOC] #40053 [NEW]: Missing installation instructions

2007-01-07 Thread todd at magnifisites dot com
From: todd at magnifisites dot com
Operating system: Windows
PHP version:  Irrelevant
PHP Bug Type: Documentation problem
Bug description:  Missing installation instructions

Description:

The MySQL Improved Extension manual page does not include instructions for
installing on Windows systems.  For example, the original MySQL Functions
page http://php.net/ref.mysql has a section specific to PHP 5+ that states
...

=
MySQL is no longer enabled by default, so the php_mysql.dll DLL must be
enabled inside of php.ini.
=

The documentation has done a great job in describing how to enable
extensions for Windows installations in general as well as how to enable
extensions for certain Function extensions (gd, curl, etc.).  However, the
current packaged PHP5 php.ini* files (both the php.ini-dist and
php.ini-recommended) do not include the php_mysqli.dll extension
configuration directive nor is there any reference to this particular
directive found on the MySQL Improved Extension manual page vi

Expected result:

Add the extension line to the php.ini-dist and the php.ini-recommended
files currently being shipped with the PHP5 distribution:

extension=php_mysqli.dll

Also, add an installation on Windows Systems instruction to the MySQL
Improved Extension manual page (the text below is taken almost verbatim
from the MySQL Functions page http://php.net/ref.mysql ):

Installation on Windows Systems

PHP 5+

MySQL Improved Extension manual page is not enabled by default, so the
php_mysqli.dll DLL must be enabled inside of php.ini. Also, PHP needs
access to the MySQL client library. A file named libmysql.dll is included
in the Windows PHP distribution and in order for PHP to talk to MySQL this
file needs to be available to the Windows systems PATH. See the FAQ titled
"How do I add my PHP directory to the PATH on Windows" for information on
how to do this. Although copying libmysql.dll to the Windows system
directory also works (because the system directory is by default in the
system's PATH), it's not recommended.

As with enabling any PHP extension (such as php_mysql.dll), the PHP
directive extension_dir should be set to the directory where the PHP
extensions are located. See also the Manual Windows Installation
Instructions. An example extension_dir value for PHP 5 is c:\php\ext

Note: If when starting the web server an error similar to the
following occurs: "Unable to load dynamic library './php_mysql.dll'", this
is because php_mysql.dll and/or libmysql.dll cannot be found by the system.



-- 
Edit bug report at http://bugs.php.net/?id=40053&edit=1
-- 
Try a CVS snapshot (PHP 4.4): 
http://bugs.php.net/fix.php?id=40053&r=trysnapshot44
Try a CVS snapshot (PHP 5.2): 
http://bugs.php.net/fix.php?id=40053&r=trysnapshot52
Try a CVS snapshot (PHP 6.0): 
http://bugs.php.net/fix.php?id=40053&r=trysnapshot60
Fixed in CVS: http://bugs.php.net/fix.php?id=40053&r=fixedcvs
Fixed in release: 
http://bugs.php.net/fix.php?id=40053&r=alreadyfixed
Need backtrace:   http://bugs.php.net/fix.php?id=40053&r=needtrace
Need Reproduce Script:http://bugs.php.net/fix.php?id=40053&r=needscript
Try newer version:http://bugs.php.net/fix.php?id=40053&r=oldversion
Not developer issue:  http://bugs.php.net/fix.php?id=40053&r=support
Expected behavior:http://bugs.php.net/fix.php?id=40053&r=notwrong
Not enough info:  
http://bugs.php.net/fix.php?id=40053&r=notenoughinfo
Submitted twice:  
http://bugs.php.net/fix.php?id=40053&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=40053&r=globals
PHP 3 support discontinued:   http://bugs.php.net/fix.php?id=40053&r=php3
Daylight Savings: http://bugs.php.net/fix.php?id=40053&r=dst
IIS Stability:http://bugs.php.net/fix.php?id=40053&r=isapi
Install GNU Sed:  http://bugs.php.net/fix.php?id=40053&r=gnused
Floating point limitations:   http://bugs.php.net/fix.php?id=40053&r=float
No Zend Extensions:   http://bugs.php.net/fix.php?id=40053&r=nozend
MySQL Configuration Error:http://bugs.php.net/fix.php?id=40053&r=mysqlcfg


[PHP-DOC] #36447 [NEW]: imagefill page, example one has invalid parameter count

2006-02-18 Thread todd at magnifisites dot com
From: todd at magnifisites dot com
Operating system: Any
PHP version:  Irrelevant
PHP Bug Type: Documentation problem
Bug description:  imagefill page, example one has invalid parameter count

Description:

Example 1 has an invalid parameter count in the documentation.  The line
reading ...
$im = imagecreatetruecolor('example.jpg', 100, 100);
... is in error.

Expected result:

A working example:

 


-- 
Edit bug report at http://bugs.php.net/?id=36447&edit=1
-- 
Try a CVS snapshot (PHP 4.4): 
http://bugs.php.net/fix.php?id=36447&r=trysnapshot44
Try a CVS snapshot (PHP 5.1): 
http://bugs.php.net/fix.php?id=36447&r=trysnapshot51
Try a CVS snapshot (PHP 6.0): 
http://bugs.php.net/fix.php?id=36447&r=trysnapshot60
Fixed in CVS: http://bugs.php.net/fix.php?id=36447&r=fixedcvs
Fixed in release: 
http://bugs.php.net/fix.php?id=36447&r=alreadyfixed
Need backtrace:   http://bugs.php.net/fix.php?id=36447&r=needtrace
Need Reproduce Script:http://bugs.php.net/fix.php?id=36447&r=needscript
Try newer version:http://bugs.php.net/fix.php?id=36447&r=oldversion
Not developer issue:  http://bugs.php.net/fix.php?id=36447&r=support
Expected behavior:http://bugs.php.net/fix.php?id=36447&r=notwrong
Not enough info:  
http://bugs.php.net/fix.php?id=36447&r=notenoughinfo
Submitted twice:  
http://bugs.php.net/fix.php?id=36447&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=36447&r=globals
PHP 3 support discontinued:   http://bugs.php.net/fix.php?id=36447&r=php3
Daylight Savings: http://bugs.php.net/fix.php?id=36447&r=dst
IIS Stability:http://bugs.php.net/fix.php?id=36447&r=isapi
Install GNU Sed:  http://bugs.php.net/fix.php?id=36447&r=gnused
Floating point limitations:   http://bugs.php.net/fix.php?id=36447&r=float
No Zend Extensions:   http://bugs.php.net/fix.php?id=36447&r=nozend
MySQL Configuration Error:http://bugs.php.net/fix.php?id=36447&r=mysqlcfg


[PHP-DOC] #32378 [NEW]: max_input_time configuration directive discrepancy

2005-03-19 Thread todd at magnifisites dot com
From: todd at magnifisites dot com
Operating system: Any
PHP version:  5.0.3
PHP Bug Type: Documentation problem
Bug description:  max_input_time configuration directive discrepancy

Description:

The PHP  max_input_time configuration directive has a default value
discrepancy within the documentation:

http://php.net/manual/en/ref.info.php#ini.max-input-time
default value 60
http://php.net/manual/en/ini.php#ini.list
default value -1

Looks to me like 60 is correct, as that is what is in the
php.ini-recommended/php.ini-dist files.


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


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

2004-08-09 Thread todd at magnifisites dot com
 ID:   28683
 User updated by:  todd at magnifisites dot com
 Reported By:  todd at magnifisites dot com
 Status:   Closed
 Bug Type: Documentation problem
 Operating System: RH Linux/Windows XP
 PHP Version:  4.3.6
 New Comment:

>>If you want to escape $, use just addcslashes($str, '$');

(Smiling) Thanks, but I was merely using that as an example.  Indeed, I
know how to accomplish my goal using the function, it's the
documentation that is misleading.  On the one hand the documentation is
referencing ASCII number ranges, then in the follow-up example it jumps
to octal representation (using the double quotations).  And yes, your
reference to the documentation regarding double-quoted strings turned
on the lights -- thank you.  Please understand my good intentions here,
trying to make the language and documentation the best it can be.  I
highly recommend an update to the addcslashes manual pages to clarify
the example is using octal representation.

Sincerely,
Todd


Previous Comments:


[2004-08-09 09:58:41] [EMAIL PROTECTED]

You need to know that "\36" is the ASCII character number 30. Read
http://www.php.net/manual/en/language.types.string.php#language.types.string.syntax.double

If you want to escape $, use just addcslashes($str, '$');

--------

[2004-08-09 01:18:52] todd at magnifisites dot com

Thanks for the response.  To clarify, which statement in the
addcslashes() documentation is incorrect?

"Use the ord() function to find the ASCII value for a character."



OK, I agree -- the ASCII value for the dollar sign character is 36. 
Now, back to the documentation...

"charlist like "\0..\37", which would escape all characters with ASCII
code between 0 and 37."

Example 1. addcslashes() example





Conclusion:
The documentation states that characters with ASCII code lower than 32
and higher than 126 are converted to octal representation.  I can
understand that.  However, as this example demonstrates, it seems the
charlist parameter expects octal values, for any range, not just those
characters with ASCII values < 32 or > 126.

Still confused.  Is it the second statement that is incorrect?  Does
the charlist parameter always expect octal values?

Thanks -- Todd



[2004-08-06 17:00:12] [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.

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.

------------

[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] #28683 [Csd->Opn]: addcslashes ASCII character conversion octal range invalid

2004-08-08 Thread todd at magnifisites dot com
 ID:   28683
 User updated by:  todd at magnifisites dot com
 Reported By:  todd at magnifisites dot com
-Status:   Closed
+Status:   Open
 Bug Type: Documentation problem
 Operating System: RH Linux/Windows XP
 PHP Version:  4.3.6
 New Comment:

Thanks for the response.  To clarify, which statement in the
addcslashes() documentation is incorrect?

"Use the ord() function to find the ASCII value for a character."



OK, I agree -- the ASCII value for the dollar sign character is 36. 
Now, back to the documentation...

"charlist like "\0..\37", which would escape all characters with ASCII
code between 0 and 37."

Example 1. addcslashes() example





Conclusion:
The documentation states that characters with ASCII code lower than 32
and higher than 126 are converted to octal representation.  I can
understand that.  However, as this example demonstrates, it seems the
charlist parameter expects octal values, for any range, not just those
characters with ASCII values < 32 or > 126.

Still confused.  Is it the second statement that is incorrect?  Does
the charlist parameter always expect octal values?

Thanks -- Todd


Previous Comments:


[2004-08-06 17:00:12] [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.

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.

------------

[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] #28683 [NEW]: addcslashes ASCII character conversion octal range invalid

2004-06-07 Thread todd at magnifisites dot com
From: todd at magnifisites dot com
Operating system: RH Linux/Windows XP
PHP version:  4.3.6
PHP Bug Type: Documentation problem
Bug description:  addcslashes ASCII character conversion octal range invalid

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


[PHP-DOC] #28283 [NEW]: path separator should be directory separator

2004-05-05 Thread todd at magnifisites dot com
From: todd at magnifisites dot com
Operating system: All
PHP version:  Irrelevant
PHP Bug Type: Documentation problem
Bug description:  path separator should be directory separator

Description:

On the dirname function page of the documentation, there is a  sentence
referring to the path separator character.  Actually, this should refer to
the directory separator character to more closely match the PHP constant
definitions of PATH_SEPARATOR and DIRECTORY_SEPARATOR.

Reproduce code:
---
The current documentation:

On Windows, both slash (/) and backslash (\) are used as path separator
character. In other environments, it is the forward slash (/).

Expected result:

On Windows, both slash (/) and backslash (\) are used as directory
separator character. In other environments, it is the forward slash (/).


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