Debian Bug report logs - #612286
README should be in /usr/share/doc/php-pear/

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Olivier Berger <olivier.berger@it-sudparis.eu>

To: Debian Bug Tracking System <submit@bugs.debian.org>

Subject: README should be in /usr/share/doc/php-pear/

Date: Mon, 07 Feb 2011 13:33:55 +0100

Package: php-pear
Version: 5.3.3-7
Severity: minor

Hi.

The PEAR README seems to be in /usr/share/doc/php5-common/PEAR/PEAR/README. However, one would expect that per Debian packaging conventions, it is in /usr/share/doc/php-pear/README.

Thanks in advance.

Best regards,


-- System Information:
Debian Release: 6.0
Architecture: i386 (i686)

Kernel: Linux 2.6.32-5-686 (SMP w/2 CPU cores)
Locale: LANG=fr_FR.utf8, LC_CTYPE=fr_FR.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages php-pear depends on:
ii  php5-cli                      5.3.3-7    command-line interpreter for the p
ii  php5-common                   5.3.3-7    Common files for packages built fr

Versions of packages php-pear recommends:
ii  gnupg                         1.4.10-4   GNU privacy guard - a free PGP rep

Versions of packages php-pear suggests:
pn  php5-dev                      <none>     (no description available)

-- debconf-show failed

Message #10 received at 612286@bugs.debian.org (full text, mbox, reply):

From: Ondřej Surý <ondrej@debian.org>

To: Olivier Berger <olivier.berger@it-sudparis.eu>, 612286@bugs.debian.org

Cc: control <control@bugs.debian.org>

Subject: Re: [php-maint] Bug#612286: README should be in /usr/share/doc/php-pear/

Date: Fri, 18 Mar 2011 16:13:12 +0100

tags 612286 +wontfix
thank you

On Mon, Feb 7, 2011 at 13:33, Olivier Berger
<olivier.berger@it-sudparis.eu> wrote:
> Package: php-pear
> Version: 5.3.3-7
> Severity: minor
>
> Hi.
>
> The PEAR README seems to be in /usr/share/doc/php5-common/PEAR/PEAR/README. However, one would expect that per Debian packaging conventions, it is in /usr/share/doc/php-pear/README.

That would break the PEAR installation which lists LICENSE and README
files installed as /usr/share/php/doc/PEAR/{LICENSE,README} and
/usr/share/php/doc is symlinked to /usr/share/doc/php5-common/PEAR/.
In another words the PEAR (first) directory includes whatever pear
install throws into it.

And I don't think it's worth creating another symlink (from PEAR/PEAR
-> PEAR) just for purity.

O.
-- 
Ondřej Surý <ondrej@sury.org>
http://blog.rfc1925.org/

Message #17 received at 612286@bugs.debian.org (full text, mbox, reply):

From: Olivier Berger <olivier.berger@it-sudparis.eu>

To: Ondřej Surý <ondrej@debian.org>

Cc: 612286@bugs.debian.org

Subject: Re: [php-maint] Bug#612286: README should be in /usr/share/doc/php-pear/

Date: Fri, 18 Mar 2011 17:08:36 +0100

Le vendredi 18 mars 2011 à 16:13 +0100, Ondřej Surý a écrit :
> tags 612286 +wontfix
> thank you
> 
> On Mon, Feb 7, 2011 at 13:33, Olivier Berger
> <olivier.berger@it-sudparis.eu> wrote:
> > Package: php-pear
> > Version: 5.3.3-7
> > Severity: minor
> >
> > Hi.
> >
> > The PEAR README seems to be in /usr/share/doc/php5-common/PEAR/PEAR/README. However, one would expect that per Debian packaging conventions, it is in /usr/share/doc/php-pear/README.
> 
> That would break the PEAR installation which lists LICENSE and README
> files installed as /usr/share/php/doc/PEAR/{LICENSE,README} 

What's the problem if PEAR's LICENSE and README aren't where PEAR
expects them ?

We are maintaining a *distribution* first, so its policy should come
first, before PEAR's or I don't understand things in the right way...

I'd object to the wontfix but don't want to be rude by changing it
before I heard your arguments ;) ... and I'm not yet DD to NMU in any
case ;)

Please, can you enlighten me ?

Thanks in advance.

Best regards,
-- 
Olivier BERGER <olivier.berger@it-sudparis.eu>
http://www-public.it-sudparis.eu/~berger_o/ - OpenPGP-Id: 2048R/5819D7E8
Ingénieur Recherche - Dept INF
Institut TELECOM, SudParis (http://www.it-sudparis.eu/), Evry (France)

Message #22 received at 612286@bugs.debian.org (full text, mbox, reply):

From: Ondřej Surý <ondrej@debian.org>

To: Olivier Berger <olivier.berger@it-sudparis.eu>

Cc: 612286@bugs.debian.org

Subject: Re: [php-maint] Bug#612286: README should be in /usr/share/doc/php-pear/

Date: Fri, 18 Mar 2011 17:50:45 +0100

> I'd object to the wontfix but don't want to be rude by changing it
> before I heard your arguments ;) ... and I'm not yet DD to NMU in any
> case ;)

Also you should probably read Developers Reference as well, especially
the NMU section...

http://www.debian.org/doc/developers-reference/pkgs.html#nmu

> Before doing an NMU, consider the following questions:
> - Does your NMU really fix bugs? Fixing cosmetic issues or changing the packaging style in NMUs is discouraged.

P.S.: I don't consider threatening with NMU in case of disagreement as
funny even though I see the smiley.
-- 
Ondřej Surý <ondrej@sury.org>
http://blog.rfc1925.org/

Message #27 received at 612286@bugs.debian.org (full text, mbox, reply):

From: Ondřej Surý <ondrej@debian.org>

To: Olivier Berger <olivier.berger@it-sudparis.eu>

Cc: 612286@bugs.debian.org

Subject: Re: [php-maint] Bug#612286: README should be in /usr/share/doc/php-pear/

Date: Fri, 18 Mar 2011 17:46:57 +0100

close 612286
thank you

> Please, can you enlighten me ?

Debian Policy is your friend...

But not to sound RTFMish... here's the relevant part:

--cut here--
12.3 Additional documentation

Any additional documentation that comes with the package may be
installed at the discretion of the package maintainer.

[...]

It is often a good idea to put text information files (READMEs,
changelogs, and so forth) that come with the source package in
/usr/share/doc/package in the binary package. However, you don't need
to install the instructions for building and installing the package,
of course!
--cut here--

And our maintainer discretion is to keep the same structure as PEAR
documentation to not make things complicated. Hence closing the bug,
no reason to keep it open.

Olivier, I know you're trying to help, but such nitpicking in a
situation when we have ~125 open bugs on src:php5 including various
segfaults in not really helping. If you have a time, it would be much
better if you could do some little bug maintenance like retesting old
bugs with php in stable, pinging old bugs if the submitter can still
reproduce the problem, etc., etc...

Ondrej
-- 
Ondřej Surý <ondrej@sury.org>
http://blog.rfc1925.org/

Message #34 received at 612286@bugs.debian.org (full text, mbox, reply):

From: Olivier Berger <olivier.berger@it-sudparis.eu>

To: Ondřej Surý <ondrej@debian.org>

Cc: 612286@bugs.debian.org

Subject: Re: [php-maint] Bug#612286: README should be in /usr/share/doc/php-pear/

Date: Fri, 18 Mar 2011 19:17:14 +0100

Le vendredi 18 mars 2011 à 17:50 +0100, Ondřej Surý a écrit :
> > I'd object to the wontfix but don't want to be rude by changing it
> > before I heard your arguments ;) ... and I'm not yet DD to NMU in any
> > case ;)
> 
> Also you should probably read Developers Reference as well, especially
> the NMU section...
> 
> http://www.debian.org/doc/developers-reference/pkgs.html#nmu
> 
> > Before doing an NMU, consider the following questions:
> > - Does your NMU really fix bugs? Fixing cosmetic issues or changing the packaging style in NMUs is discouraged.
> 
> P.S.: I don't consider threatening with NMU in case of disagreement as
> funny even though I see the smiley.

I was just thinking that maybe one could have responded with something
like : "if you don't like it this way, feel free to fix it yourself",
which I couldn't have done as I am no DD.

Anyway, enough wasting everyone's time.

Thanks for your kind answers.

Best regards,
-- 
Olivier BERGER <olivier.berger@it-sudparis.eu>
http://www-public.it-sudparis.eu/~berger_o/ - OpenPGP-Id: 2048R/5819D7E8
Ingénieur Recherche - Dept INF
Institut TELECOM, SudParis (http://www.it-sudparis.eu/), Evry (France)

Message #39 received at 612286@bugs.debian.org (full text, mbox, reply):

From: Thomas Goirand <thomas@goirand.fr>

To: Olivier Berger <olivier.berger@it-sudparis.eu>, 612286@bugs.debian.org, Ondřej Surý <ondrej@debian.org>

Subject: Re: [php-maint] Bug#612286: Bug#612286: README should be in /usr/share/doc/php-pear/

Date: Sat, 19 Mar 2011 08:15:15 +0800

----- Original message -----
> I was just thinking that maybe one could have responded with something
> like : "if you don't like it this way, feel free to fix it yourself",
> which I couldn't have done as I am no DD.

Excuse me Olivier but you are just plain wrong with
this statement. Even not being a DD, you can
download any Git repo from alioth and prepare
patches. As you are part of the php-pkg group on
alioth, you have write access too, so you could
(for example) create your own branch and ask others
to have a look, and do a "git merge olivier-branch"
(or also, pull from any URL you'd like).

In short: you CAN fix it yourself, but you wont be
able to upload without asking others.

Thomas

Send a report that this bug log contains spam.