Doc #55756 [Asn->Csd]: Incorrect information in introduction

Edit report at https://bugs.php.net/bug.php?id=55756&edit=1 ID: 55756 Updated by: aharvey@php.net Reported by: ned dot leitch at gmail dot com Summary: Incorrect information in introduction -Status: Assigned +Status: Closed Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant 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: ------------------------------------------------------------------------ [2011-09-24 19:53:56] aharvey@php.net Automatic comment from SVN on behalf of aharvey Revision: http://svn.php.net/viewvc/?view=revision&revision=317255 Log: Fix doc bug #55756 (Incorrect information in introduction) by removing the offending sentence. ------------------------------------------------------------------------ [2011-09-21 13:59:47] ned dot leitch at gmail dot com Description: ------------ The introductory paragraph to using Phars at http://www.php.net/manual/en/phar.using.intro.php contains a factual error. Specifically, the sentence: "Unlike Java's implementation of JAR archives, no external tool is required to process or run a PHP Phar archive." is incorrect, as JARs are executed by Java natively ("java -jar" does the trick). I'm not sure what's meant by the use of the word "process", but you'll need to write a PHP utility program to create/update/manipulate a Phar, just as you would with Java (unless you count the ability to use "jar" or the ubiquitous "zip" program). I've seen this sentence reproduced several times on the Internet already, and don't know what service it does to the PHP community. Regardless of the accuracy of the statement, I don't see what it adds to the utility of the documentation. Visitors to the page want to see how to use a Phar, not why PHP people think it's better than other technologies. ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=55756&edit=1