Doc #68239 [Ver->Csd]: Incorrect documentation or library bug

Edit report at https://bugs.php.net/bug.php?id=68239&edit=1 ID: 68239 Updated by: aharvey@php.net Reported by: richard at sublogic dot se Summary: Incorrect documentation or library bug -Status: Verified +Status: Closed Type: Documentation Problem Package: GD related Operating System: Archlinux PHP Version: 5.6.1 -Assigned To: pajoye +Assigned To: aharvey Block user comment: N Private report: N 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: ------------------------------------------------------------------------ [2014-11-07 10:16:22] aharvey@php.net Automatic comment from SVN on behalf of aharvey Revision: http://svn.php.net/viewvc/?view=revision&revision=335164 Log: Note the fix for bug #65171, and generally flesh out the imagescale() docs. Fixes doc bug #68239 (Incorrect documentation or library bug). ------------------------------------------------------------------------ [2014-11-05 15:13:09] remi@php.net FYI the bug #65171 is fix in upcoming 5.5.19 / 5.6.3 ------------------------------------------------------------------------ [2014-10-17 13:44:20] tyrael@php.net I think we should either fix the arginfo and the docs to make the height mandatory, or it should work when the argument is omitted. ------------------------------------------------------------------------ [2014-10-15 18:14:56] richard at sublogic dot se Description: ------------ --- From manual page: http://www.php.net/function.imagescale --- The function imagescale either has an implementation bug floating around or the documentation is wrong. The issue is with the $height parameter. The docs say it can optionally be provided but the reality is the following error: Warning: imagescale(): gd warning: one parameter to a memory allocation multiplication is negative or zero, failing operation gracefully ... Link: https://bugs.php.net/bug.php?id=65171 The only way for imagescale() to function properly at present is to explicitly provide a value for $height. It would be very helpful if the docs gave a warning on this issue. Test script: --------------- $imageres = imagecreatetruecolor(600, 500); $imageres = imagescale($imageres, 380, 380); imagejpeg($imageres, $dstdir . $filename); imagedestroy($imageres); ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=68239&edit=1