Doc #55756 [Opn->Asn]: Incorrect information in introduction
| From: | aharvey@php.net | Date: | Sat, 24 Sep 2011 19:50:58 +0000 |
| Subject: | Doc #55756 [Opn->Asn]: Incorrect information in introduction | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-7254@lists.php.net to get a copy of this message | ||
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: Open
+Status: Assigned
Type: Documentation Problem
-Package: PHAR related
+Package: Documentation problem
PHP Version: Irrelevant
-Assigned To:
+Assigned To: aharvey
Block user comment: N
Private report: N
Previous Comments:
------------------------------------------------------------------------
[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