Bug 12442 - php-pear-PhpDocumentor: empty package, no phpdoc command
Summary: php-pear-PhpDocumentor: empty package, no phpdoc command
Status: RESOLVED FIXED
Alias: None
Product: Mageia
Classification: Unclassified
Component: RPM Packages (show other bugs)
Version: 3
Hardware: x86_64 Linux
Priority: Normal major
Target Milestone: ---
Assignee: QA Team
QA Contact:
URL:
Whiteboard: has_procedure mga3-32-ok mga3-64-ok
Keywords: Triaged, validated_update
Depends on:
Blocks: 13224
  Show dependency treegraph
 
Reported: 2014-01-26 14:44 CET by franck villaume
Modified: 2014-04-16 17:05 CEST (History)
4 users (show)

See Also:
Source RPM: php-pear-PhpDocumentor-1.4.4-2.mga3.src.rpm
CVE:
Status comment:


Attachments

Description franck villaume 2014-01-26 14:44:40 CET
Description of problem:
I installed the php-pear-PhpDocumentor package.
The package provides only directories. No files, no tools. No phpdoc command.
The package is useless since it's not providing any utilities.

Version-Release number of selected component (if applicable):
1.4.4

How reproducible:
Always.

Steps to Reproduce:
1. Install the rpm
2. Check for the phpdoc command.



Reproducible: 

Steps to Reproduce:
Manuel Hiebel 2014-01-28 18:45:42 CET

Keywords: (none) => Triaged
Assignee: bugsquad => thomas

Comment 1 Thomas Spuhler 2014-01-28 18:57:41 CET
Agree

Status: NEW => ASSIGNED

Comment 2 Thomas Spuhler 2014-02-01 22:42:49 CET
I have put a fix into updates-testing. Could you please test it.
BTW,this package has been empty for a very long time (since version 1.4.4 at least). This package has been superseded by upstream. It still uses smarty-2.
If you don't actually uses it, we may replace it with phpDocumentor-2.2.0
Note capitalization difference.
Comment 3 franck villaume 2014-02-03 12:03:04 CET
Hi Thomas,

thanks for the updated package but ...

phpdoc is not usable.

Here is the output : 
Fatal error: Uncaught exception 'SmartyException' with message 'Call of unknown method 'register_outputfilter'.' in /usr/share/php/Smarty/sysplugins/smarty_internal_templatebase.php:806

Fix available here :
https://bugzilla.redhat.com/show_bug.cgi?id=863639


About phpDocumentor 2.2.0, I'm fine with the proposition. The current official package is useless. Any new version is welcome as long as it relies on mageia 3.


Regards,
Franck
Comment 4 Thomas Spuhler 2014-02-28 19:27:52 CET
I uploaded a version that includes the Fedora patch. 
Would you mind to test it?
(When I run the tests in the build, it reports 8 errors. But they may not cause any harm)
phpDocumentor-2.2.0 that superseded this package is still under heavy development and has now version 2.3.1 and has a slightly different name spelling. I am hesitant to pack-port it to mga3. It is in Cauldron for mga5
Comment 5 franck villaume 2014-03-04 13:17:27 CET
Hi Thomas,

thank you for the update.
Here is the end of the output.
The warning about timezone is harmless.
But phpdoc still crash.

Sorting @todo list...done
Converting tutorials/extended docs
Formatting Package Indexes...
Warning: date(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone. in /usr/share/pear/PhpDocumentor/phpDocumentor/Converter.inc on line 5088

Fatal error: Call to undefined method Smarty::registerFilter() in /usr/share/pear/PhpDocumentor/phpDocumentor/Converters/HTML/frames/HTMLframesConverter.inc on line 608


Smarty package is installed.
[root@localhost ~]# rpm -q php-smarty
php-smarty-3.1.11-4.mga3

Regards,
Franck
Comment 6 franck villaume 2014-03-04 13:20:56 CET
btw, I presume the phpDocumentor from mga4 is broken too ?
package mga4 is 40k
package mga3 in update_testing is ~950k

Regards,
Franck
Comment 7 Thomas Spuhler 2014-03-04 18:33:37 CET
(In reply to franck villaume from comment #6)
> btw, I presume the phpDocumentor from mga4 is broken too ?
> package mga4 is 40k
> package mga3 in update_testing is ~950k
> 
> Regards,
> Franck

yes, no need to work on it as long as it doesn't work on mga3.

Did you ever try if a pear install works. This is usually the excuse I get from the pear developers when reporting a bug.
Comment 8 franck villaume 2014-03-10 10:34:15 CET
I removed the rpm phpdocumentor and run : pear install phpdocumentor-1.4.4

[root@localhost ~]# pear install PhpDocumentor-1.4.4
WARNING: "pear/PhpDocumentor" is deprecated in favor of "channel://pear.phpdoc.org/phpdocumentor"
downloading PhpDocumentor-1.4.4.tgz ...
Starting to download PhpDocumentor-1.4.4.tgz (1,534,088 bytes)
..............................................................................................................................................................................................................................................................................................................done: 1,534,088 bytes
install ok: channel://pear.php.net/PhpDocumentor-1.4.4

And it works like expected.
No errors, no crash.
Comment 9 Thomas Spuhler 2014-03-25 00:32:27 CET
Frank:
If you are still happy I will upgrade it to the vanilla PhpDocumentor-1.4.4.tgz
Comment 10 Thomas Spuhler 2014-03-25 21:37:05 CET
OK, I put a vanilla upstream package into mga3 upgrades_testing.
I noticed, it has the smarty-2.6 libraris built in, so it may work w/o the patch that make is fail. (we have samrty-3.x)
I am not familiar with the package.
Would you please tell me how to test it.
Thomas Spuhler 2014-03-25 21:37:18 CET

CC: (none) => thomas

Comment 11 franck villaume 2014-03-30 14:02:59 CEST
Hi,

sorry for the delay. I'm not sure how to help here.
I'm using phpdoc to generate documentation of a big php project aka 'fusionforge'. The command i'm using is very basic :
phpdoc -d mydirectory_to_parse -t thedirectory_to_save_the_doc



The new package php-pear-PhpDocumentor-1.4.4-2.4.mga3.noarch.rpm cannot be installed. Dependency may be wrong.

A requested package cannot be installed:
php-pear-PhpDocumentor-1.4.4-2.4.mga3.noarch (due to unsatisfied pear(PEAR/PackageFileManager.php))

But mageia is shipping php-pear-PackageFileManager2.

rpm -q php-pear-PackageFileManager2
php-pear-PackageFileManager2-1.0.2-2.mga3

rpm -ql php-pear-PackageFileManager2 | grep 'PEAR/PackageFileManager'
/usr/share/pear/PEAR/PackageFileManager2.php

I force the install using the nodeps flag.
And the package works like expected.
Comment 12 Thomas Spuhler 2014-03-30 20:53:10 CEST
Thanks Franck. I just imported php-pear-PackageFileManager and it now installs.
This bug is now fixed by using the tarball from upstream w/o smarty-3 patches (the provide the smarty libs in the package)

The following packages are now in updates_testing:
php-pear-PEAR_PackageFileManager-1.7.0-1.mga3.src.rpm
php-pear-PEAR_PackageFileManager-1.7.0-1.mga3.noarch.rpm

php-pear-PhpDocumentor-1.4.4-2.4.mga3.src.rpm
php-pear-PhpDocumentor-1.4.4-2.4.mga3.noarch.rpm
assigning this to QA
Thomas Spuhler 2014-03-30 20:53:34 CEST

Assignee: thomas => qa-bugs

claire robinson 2014-04-04 13:59:24 CEST

Whiteboard: (none) => has_procedure

Comment 13 claire robinson 2014-04-04 14:26:08 CEST
Testing complete mga3 32

Before
------
# phpdoc
-bash: phpdoc: command not found

# urpmf php-pear-PhpDocumentor | grep doc
php-pear-PhpDocumentor:/usr/share/pear/PhpDocumentor/phpDocumentor/Converters/XML/DocBook/peardoc2

# urpmf php-pear-PhpDocumentor | grep bin


After
-----
# urpmi php-pear-PhpDocumentor
To satisfy dependencies, the following packages are going to be installed:
  Package                        Version      Release       Arch    
(medium "Core Release")
  php-pear-Console_Color         1.0.3        2.mga3        noarch  
  php-pear-Console_Getargs       1.3.5        2.mga3        noarch  
  php-pear-Console_Table         1.1.4        2.mga3        noarch  
  php-pear-Event_Dispatcher      1.1.0        4.mga3        noarch  
  php-pear-File_Find             1.3.1        2.mga3        noarch  
  php-pear-HTML_CSS              1.5.4        4.mga3        noarch  
  php-pear-HTML_Common           1.2.5        4.mga3        noarch  
  php-pear-HTML_Table            1.8.3        3.mga3        noarch  
  php-pear-HTTP_Request2         2.1.1        2.mga3        noarch  
  php-pear-Net_URL2              2.0.0        2.mga3        noarch  
  php-pear-PEAR_PackageFileMana> 1.0.2        3.mga3        noarch  
  php-pear-PHP_CompatInfo        1.9.0        5.mga3        noarch  
  php-pear-PackageFileManager2   1.0.2        2.mga3        noarch  
  php-pear-Services_W3C_CSSVali> 0.2.2        2.mga3        noarch  
  php-pear-XML_Beautifier        1.2.2        2.mga3        noarch  
(medium "Core Updates Testing")
  php-pear-PEAR_PackageFileMana> 1.7.0        1.mga3        noarch  
  php-pear-PhpDocumentor         1.4.4        2.4.mga3      noarch  
9MB of additional disk space will be used.
1.5MB of packages will be retrieved.
Proceed with the installation of the 17 packages? (Y/n) y

# urpmf --media "Core Updates Testing" php-pear-PhpDocumentor | grep bin
php-pear-PhpDocumentor:/usr/bin/phpdoc

# phpdoc -d /var/www/wordpress -t ~/phpdocs
PHP Version 5.4.26
phpDocumentor version 1.4.4

Parsing configuration file phpDocumentor.ini...
   (found in /usr/share/pear/data/PhpDocumentor/)...

done
using tokenizer Parser


Grabbing README/INSTALL/CHANGELOG
...etc


# ls ~/phpdocs/
blank.html  elementindex.html  errors.html  li_WordPress.html  packages.html
classtrees_WordPress.html  elementindex_WordPress.html  index.html   media/             WordPress/

Whiteboard: has_procedure => has_procedure mga3-32-ok

Comment 14 David GEIGER 2014-04-05 19:10:16 CEST
Tested mga3_64,

Testing complete for php-pear-PhpDocumentor-1.4.4-2.4.mga3, Ok for me same result as claire.

Before :
# phpdoc
-bash: phpdoc: command not found

# urpmf php-pear-PhpDocumentor | grep doc
php-pear-PhpDocumentor:/usr/share/pear/PhpDocumentor/phpDocumentor/Converters/XML/DocBook/peardoc2

# urpmf php-pear-PhpDocumentor | grep bin

----------------------------------------------------------------------------------
After :
# LC_ALL=C urpmi php-pear-PhpDocumentor
To satisfy dependencies, the following packages are going to be installed:
  Package                        Version      Release       Arch    
(medium "Core Release (distrib1)")
  lib64mbfl1                     1.2.0        7.mga3        x86_64  
  lib64onig2                     5.9.2        3.mga3        x86_64  
  php-channel-phpunit            1.3          9.mga3        noarch  
  php-pear-Console_Color         1.0.3        2.mga3        noarch  
  php-pear-Console_Getargs       1.3.5        2.mga3        noarch  
  php-pear-Console_Table         1.1.4        2.mga3        noarch  
  php-pear-DbUnit                1.1.2        2.mga3        noarch  
  php-pear-Event_Dispatcher      1.1.0        4.mga3        noarch  
  php-pear-File_Find             1.3.1        2.mga3        noarch  
  php-pear-File_Iterator         1.3.1        2.mga3        noarch  
  php-pear-HTML_CSS              1.5.4        4.mga3        noarch  
  php-pear-HTML_Common           1.2.5        4.mga3        noarch  
  php-pear-HTML_Table            1.8.3        3.mga3        noarch  
  php-pear-HTTP_Request2         2.1.1        2.mga3        noarch  
  php-pear-Net_URL2              2.0.0        2.mga3        noarch  
  php-pear-PEAR_PackageFileMana> 1.0.2        3.mga3        noarch  
  php-pear-PHPUnit               3.6.11       2.mga3        noarch  
  php-pear-PHPUnit_MockObject    1.1.1        2.mga3        noarch  
  php-pear-PHPUnit_Selenium      1.2.7        2.mga3        noarch  
  php-pear-PHPUnit_Story         1.0.0        3.mga3        noarch  
  php-pear-PHP_CodeCoverage      1.1.3        2.mga3        noarch  
  php-pear-PHP_CompatInfo        1.9.0        5.mga3        noarch  
  php-pear-PHP_Invoker           1.1.0        2.mga3        noarch  
  php-pear-PHP_Timer             1.0.2        2.mga3        noarch  
  php-pear-PHP_TokenStream       1.1.3        2.mga3        noarch  
  php-pear-PackageFileManager2   1.0.2        2.mga3        noarch  
  php-pear-Services_W3C_CSSVali> 0.2.2        2.mga3        noarch  
  php-pear-Text_Template         1.1.4        2.mga3        noarch  
  php-pear-XML_Beautifier        1.2.2        2.mga3        noarch  
  php-pear-XML_Parser            1.3.4        2.mga3        noarch  
  php-pear-XML_Serializer        0.20.2       5.mga3        noarch  
  php-pear-channel-horde         1.0          16.mga3       noarch  
  php-pear-channel-symfony       1.0          8.mga3        noarch  
  php-symfony-YAML               1.0.6        3.mga3        noarch  
(medium "Core Updates Testing (distrib5)")
  lib64php5_common5              5.4.27       1.mga3        x86_64  
  php-mbstring                   5.4.27       1.mga3        x86_64  
  php-mysql                      5.4.27       1.mga3        x86_64  
  php-mysqlnd                    5.4.27       1.mga3        x86_64  
  php-pear-PEAR_PackageFileMana> 1.7.0        1.mga3        noarch  
  php-pear-PhpDocumentor         1.4.4        2.4.mga3      noarch 
13MB of additional disk space will be used.
3.7MB of packages will be retrieved.
Proceed with the installation of the 40 packages? (Y/n) Y

# urpmf --media "Core Updates Testing" php-pear-PhpDocumentor | grep bin
php-pear-PhpDocumentor:/usr/bin/phpdoc

# ls /usr/bin/phpd*
/usr/bin/phpdoc*

# phpdoc -d /var/www/html -t ~/phpdocs
PHP Version 5.4.27
phpDocumentor version 1.4.4

Parsing configuration file phpDocumentor.ini...
   (found in /usr/share/pear/data/PhpDocumentor/)...

done
using tokenizer Parser


Grabbing README/INSTALL/CHANGELOG

done
....etc

# ls ~/phpdocs/media/
banner.css  stylesheet.css

CC: (none) => geiger.david68210
Whiteboard: has_procedure mga3-32-ok => has_procedure mga3-32-ok mga3-64-ok

Comment 15 claire robinson 2014-04-08 12:30:23 CEST
No advisory text given, uploaded as ..

description: |
  Updated php-pear-PhpDocumentor correct a packaging error which meant the 
  phpdoc command was not available.

Validating.

Could sysadmin please push to 3 updates

Thanks

Keywords: (none) => validated_update
CC: (none) => sysadmin-bugs

Comment 16 Damien Lallement 2014-04-08 14:40:38 CEST
http://advisories.mageia.org/MGAA-2014-0098.html

Status: ASSIGNED => RESOLVED
CC: (none) => mageia
Resolution: (none) => FIXED

Thomas Spuhler 2014-04-16 17:05:51 CEST

Blocks: (none) => 13224


Note You need to log in before you can comment on or make changes to this bug.