Doc #55756 [NEW]: Incorrect information in introduction

From: Date: Wed, 21 Sep 2011 13:59:47 +0000
Subject: Doc #55756 [NEW]: Incorrect information in introduction
Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-7241@lists.php.net to get a copy of this message
From: Operating system: PHP version: Irrelevant Package: PHAR related Bug Type: Documentation Problem Bug description:Incorrect information in introduction 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 bug report at https://bugs.php.net/bug.php?id=55756&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=55756&r=trysnapshot54 Try a snapshot (PHP 5.3): https://bugs.php.net/fix.php?id=55756&r=trysnapshot53 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=55756&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=55756&r=fixed Fixed in SVN and need be documented: https://bugs.php.net/fix.php?id=55756&r=needdocs Fixed in release: https://bugs.php.net/fix.php?id=55756&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=55756&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=55756&r=needscript Try newer version: https://bugs.php.net/fix.php?id=55756&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=55756&r=support Expected behavior: https://bugs.php.net/fix.php?id=55756&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=55756&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=55756&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=55756&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=55756&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=55756&r=dst IIS Stability: https://bugs.php.net/fix.php?id=55756&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=55756&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=55756&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=55756&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=55756&r=mysqlcfg

« previous php.doc.bugs (#7241) next »