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
View Add Comment Developer Edit
Welcome! If you don't have a Git account, you can't do anything here.
You can add a comment by following this link or if you reported this bug, you can edit this bug over here.
(description)
Block user comment
Status: Assign to:
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: Fri Apr 19 23:01:28 2024 UTC