php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #55756 Incorrect information in introduction
Submitted: 2011-09-21 13:59 UTC Modified: 2011-09-24 19:54 UTC
From: ned dot leitch at gmail dot com Assigned: aharvey (profile)
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If this is not your bug, you can add a comment by following this link.
If this is your bug, but you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: ned dot leitch at gmail dot com
New email:
PHP Version: OS:

 

 [2011-09-21 13:59 UTC] 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.


Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2011-09-24 19:50 UTC] aharvey@php.net
-Status: Open +Status: Assigned -Package: PHAR related +Package: Documentation problem -Assigned To: +Assigned To: aharvey
 [2011-09-24 19:53 UTC] 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-24 19:54 UTC] aharvey@php.net
-Status: Assigned +Status: Closed
 [2011-09-24 19:54 UTC] aharvey@php.net
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.


 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Sun Apr 28 21:01:29 2024 UTC