php-pear installs a stale symlink

Binary package hint: php-pear

So, I did a clean PEAR install, these are the steps:

till@till-laptop:~$ sudo apt-get remove php-pear
till@till-laptop:~$ sudo rm -rf /usr/share/php
till@till-laptop:~$ sudo apt-get install php-pear

After the (re-)install, the doc symlink is:
till@till-laptop:~$ ls -lah /usr/share/php/doc
lrwxrwxrwx 1 root root 20 2009-10-14 15:08 /usr/share/php/doc -> ../doc/php-pear/PEAR

Let's try to install a package:

till@till-laptop:~$ sudo pear install Console_CommandLine
downloading Console_CommandLine-1.1.0.tgz ...
Starting to download Console_CommandLine-1.1.0.tgz (37,554 bytes)
..........done: 37,554 bytes

Warning: mkdir(): File exists in System.php on line 277

Warning: mkdir(): File exists in /usr/share/php/System.php on line 277

Call Stack:
    0.0019 354672 1. {main}() /usr/share/php/pearcmd.php:0
    0.1112 4729504 2. PEAR_Command_Common->run() /usr/share/php/pearcmd.php:305
    0.1112 4730016 3. PEAR_Command_Install->doInstall() /usr/share/php/PEAR/Command/Common.php:271
    1.2047 14022904 4. PEAR_Installer->install() /usr/share/php/PEAR/Command/Install.php:708
    1.6742 14312120 5. PEAR_Installer->_installFile2() /usr/share/php/PEAR/Installer.php:1406
    1.6748 14324424 6. PEAR_Installer->mkDirHier() /usr/share/php/PEAR/Installer.php:547
    1.6748 14325768 7. PEAR_Common->mkDirHier() /usr/share/php/PEAR/Installer.php:997
    1.6749 14326568 8. System->mkDir() /usr/share/php/PEAR/Common.php:234
    1.6753 14331480 9. mkdir() /usr/share/php/System.php:277

ERROR: failed to mkdir /usr/share/php/doc/Console_CommandLine/docs/examples

(To get a more detailed output run sudo pear -vvvv install Console_CommandLine.)

Expected behavior is that the package installs. But it doesn't:

till@till-laptop:~$ pear list Console_CommandLine
`Console_CommandLine' not installed

Intermediate fix:
till@till-laptop:~$ cd /usr/share/php
till@till-laptop:~$ sudo rm doc && sudo mkdir doc

Output after the "fix":
till@till-laptop:~$ sudo pear install Console_CommandLine
downloading Console_CommandLine-1.1.0.tgz ...
Starting to download Console_CommandLine-1.1.0.tgz (37,554 bytes)
..........done: 37,554 bytes
install ok: channel://pear.php.net/Console_CommandLine-1.1.0

till@till-laptop:/usr/share/php$ pear list Console_CommandLine
Installed Files For Console_CommandLine
=======================================
Type Install Path
php /usr/share/php/Console/CommandLine/Action.php
php /usr/share/php/Console/CommandLine/Argument.php
php /usr/share/php/Console/CommandLine/Command.php
[... truncated ...]

(Installed correctly.)

My system:
Linux till-laptop 2.6.31-14-generic #46-Ubuntu SMP Tue Oct 13 16:47:28 UTC 2009 x86_64 GNU/Linux

(Updated Karmic 5 minutes ago, so this should be pretty current.)

till@till-laptop:~$ apt-cache policy php-pear
php-pear:
  Installed: 5.2.10.dfsg.1-2ubuntu5
  Candidate: 5.2.10.dfsg.1-2ubuntu5
  Version table:
 *** 5.2.10.dfsg.1-2ubuntu5 0
        500 http://ubuntu.intergenia.de karmic/main Packages
        100 /var/lib/dpkg/status

We can reproduce this bug on 32bit and 64bit karmic installs.

ProblemType: Bug
Architecture: amd64
Date: Wed Oct 14 15:34:56 2009
DistroRelease: Ubuntu 9.10
Package: php-pear 5.2.10.dfsg.1-2ubuntu5
PackageArchitecture: all
ProcEnviron:
 LANG=en_US.UTF-8
 SHELL=/bin/bash
ProcVersionSignature: Ubuntu 2.6.31-14.46-generic
SourcePackage: php5
Uname: Linux 2.6.31-14-generic x86_64