Doc #51539 [Opn->Ver]: Undocumented idn_to_ascii behaviour and availability

Edit report at http://bugs.php.net/bug.php?id=51539&edit=1 ID: 51539 Updated by: philip@php.net Reported by: tokul at users dot sourceforge dot net Summary: Undocumented idn_to_ascii behaviour and availability -Status: Open +Status: Verified Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant -Assigned To: +Assigned To: philip Block user comment: N New Comment: You're right, the "bundled with 5.3+" part is not documented well [for intl] so also needs improvement. Previous Comments: ------------------------------------------------------------------------ [2010-08-11 15:21:43] tokul at users dot sourceforge dot net IMHO documentation does not say that extension is bundled with PHP from some version. If that's default format of your docs, it is way too laconic for API documentation. If you think that this version thing is correct, fine. But boolean false on failure should be noted in documentation. ------------------------------------------------------------------------ [2010-08-10 07:43:47] philip@php.net Because intl is bundled with PHP as of 5.3.0, I think it's fairly clear. How would you suggest it be clearer? Keeping in mind that this format is used throughout the manual. As for return value, I agree, it should be updated. ------------------------------------------------------------------------ [2010-04-12 11:12:14] tokul at users dot sourceforge dot net Description: ------------ PHP intl extension manual (http://www.php.net/manual/en/ref.intl.idn.php) does not say that idn_to_utf8() and idn_to_ascii() functions are available in PECL IDN extension on older PHP versions. "PHP 5 >= 5.3.0, PECL intl >= 1.0.2" is unclear. Is it PHP 5.3.0+ AND intl 1.0.2+ extension or PHP 5.3.0+ OR intl 1.0.2+ extension. Documentation states that function returns string, but idn_to_ascii() can also return boolean false on failure. (Tested on PHP 5.2.9 with intl 1.1.1 extension) Test script: --------------- var_dump(idn_to_ascii("\xa0.org")); Actual result: -------------- bool(false) ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/bug.php?id=51539&edit=1