Doc #55756 [NEW]: Incorrect information in introduction
| From: | ned dot leitch at gmail dot com | 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