[php-maint] Bug#602865: Bug#602865: /usr/share/php/doc both in php-pear and in php-net-smtp packages

[Thomas Goirand]

On 11/08/2010 10:19 AM, Gonzalo Pérez de Olaguer Córdoba (by way of
Gonzalo Pérez de Olaguer Córdoba <gpoc at iies.es>) wrote:
> Package: php-pear
> Version: 5.2.6.dfsg.1-1+lenny9
> Severity: important
> 
> 
> Package php-pear makes /usr/share/php/doc a symlink
> Package php-net-smtp makes /usr/share/php/doc a directory
> 
> This makes installation of both packages fail.

If that was truth, IMHO, the seriousness for this issue would be
"grave", as per the definition: "makes the package in question unusable
by most or all users". Indeed, how could we use the package if we can't
even install it?

> By the way, I had both packages installed without problems.
> The problem became when upgrading apt-net-smtp from version
> 1.3.1-1 (lenny) to 1.4.2-1 (squeeze) with php-pear version
> 5.2.6.dfsg.1-1+lenny9 installed.
> 
> I ignore if the debian policy for php packages tells how
> to handle the /usr/share/php/doc directory, but probably it should.

The Debian policy is pretty clear that all documentations of packages
should go in /usr/share/doc/$PACKAGE. php-* packages don't differ from
others. Now, I can see that *MANY* pear packages could have an issues,
because CDBS create symlinks in /usr/share/php/doc/$PACKAGE, but read
further...

What I don't understand, is that I do have php-pear and php-net-smtp on
my system, and it isn't creating any conflict at all. php-net-smtp on
Lenny doesn't even carry a folder in /usr/share/php/doc. I've tried to
apt-get --reinstall install both php-pear and php-net-smtp, and it
worked well. That leads me to believe that the issue is when upgrading
from php-pear AND php-net-smtp in Lenny (but that's only a wild guess)
to Squeeze.

Can you explain a bit more how you had the issue? I'd be happy to fix
it, but currently, I couldn't reproduce it.

Thomas Goirand (zigo)

P.S: Guillaume Delacour is the last uploader, which is why I've put him
as Cc:.