Home » Tools and Utilities » PhpDocumentor » Bug #2077

[2004-08-06 23:01 UTC] asielb+pear at gmail dot com

Description:
------------
The package.xml file is missing from the PhpDocumentor-1.3.0RC3.tgz download available from the pear website. The tar file avaliable from sourceforge does not have this problem.

[2005-03-01 09:47 UTC] smith at backendmedia dot com

Thank you for your bug report. This issue has been fixed
in the latest released version of the package, which you can download at
http://pear.php.net/get/PhpDocumentor

I dont know if the original release was pulled in favor of the current release. But the problem doesnt seem to be present in the current uploaded release.

[2006-02-27 18:03 UTC] jnewman at whiteboardlabs dot com

package.xml is still missing from the tgz file in the link above (RC5).

[2006-02-27 18:18 UTC] asielb+pear at gmail dot com

I am still having the same problem that was originally reported. The package.xml file is missing from the 1.3.0RC5 that is downloaded from the link above. It is also missing from the latest file available on sourceforge (1.3.0RC4) in both the tar and zip files.

The only way I was able to install was through using pear itself and pointing it to the "beta" version for PhpDocumentor.

[2006-02-27 18:20 UTC] jeichorn at php dot net

The pear downloads are packaged like:

package.xml
Phpdocumentor/files

So this bug gets filed by people who just don't see the package file since its not where they expect it to be.

[2006-02-27 18:36 UTC] asielb+pear at gmail dot com

It still appears this file is nowhere in the tar file I downloaded. I can do a: find . -name "*.xml" from the root of the extracted tar file and no xml files are found.

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

If the file was in Phpdocumentor/files this is good to know. The INSTALL file should be updated to reflect this though.

The INSTALL file says:

Simply run

pear install /path/to/phpDocumentor-1.3.0/package.xml

Which is incorrect if the package.xml is in Phpdocumentor/files.

Hopefully this info helps in fixing the problem.

[2006-02-27 18:45 UTC] jeichorn at php dot net

Again the file is there, if you download phpDocumentor 1.3.0rc5 and extract it you'll get:
package.xml
PhpDocumentor-1.3.0RC5 (directory)

If you look at in the PhpDocumentor folder you won't find package.xml since its at the same level.

[2006-02-27 19:02 UTC] asielb+pear at gmail dot com

Indeed. Now I see what you are referring to.
The INSTALL doc is misleading then. By reading the doc it appears the package.xml file is inside the directory that the other files are extracted to. So changing the INSTALL doc to be more clear would be my only recommendation.

Thanks for the clarification.

[2006-02-27 20:00 UTC] jeichorn at php dot net

I just verified the rc5 tarball, im not sure what your doing but its there.

wget http://pear.php.net/get/PhpDocumentor
tar xvfz PhpDocumentor
ll package.xml
ls package.xml
package.xml

You can also verify like: [jeichorn@bluga tmp]$ tar xvfz PhpDocumentor | grep package.xml
package.xml
PhpDocumentor-1.3.0RC5/scripts/create_package.xml.php

[2006-02-27 20:07 UTC] asielb+pear at gmail dot com

I do see the file. The only other suggestion I had was to update the INSTALL document. It is misleading as the path shown makes it appear as if the package.xml file is inside the same directory as all the other files.

[2006-04-19 19:25 UTC] me at brenthagany dot com

Dang right it's misleading. Either this is a persistent mistake (it is still present in 1.3RC5), or you don't realize that it breaks the install. Trying to install with package.xml in its default location results in the following error:
ERROR: ./docbuilder/images/rc-gui-install-24.png does not exist

Clearly, your installer still expects package.xml to be in the untar directory with everything else, just like your documentation says. It's an easy fix, but why distribute it like this? Be nice to the noobs.

[2006-04-19 19:31 UTC] me at brenthagany dot com

By the way, if you googled this thread, and are still confused, here is the fix. In the directory with the .tgz file you downloaded, do this:

$ tar xvfz PhpDocumentor-[insert version here]
$ cp package.xml PhpDocumentor-[insert version here]
$ cd PhpDocumentor-[insert version here]
$ pear install package.xml

That should work for most. I don't have pear in my path, and I also have to force execution, so I have to do /path/to/pear/./pear install package.xml. Hope that helps.