FAQ
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

Search Discussions

  • Aharvey at Sep 24, 2011 at 7:51 pm
    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.



    ------------------------------------------------------------------------
  • Aharvey at Sep 24, 2011 at 7:54 pm
    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: Assigned
    +Status: Closed
    Type: Documentation Problem
    Package: Documentation problem
    PHP Version: Irrelevant
    Assigned To: aharvey
    Block user comment: N
    Private report: N

    New Comment:

    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.




    Previous Comments:
    ------------------------------------------------------------------------
    [2011-09-24 19:53:56] 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-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.



    ------------------------------------------------------------------------

Related Discussions

Discussion Navigation
viewthread | post
Discussion Overview
groupphp-doc-bugs @
categoriesphp
postedSep 21, '11 at 2:00p
activeSep 24, '11 at 7:54p
posts3
users2
websitephp.net

People

Translate

site design / logo © 2019 Grokbase