Placement of %doc

[Remi Collet]

Hi,

I'm searching info about %doc placement.

Most of %doc files (from source tree) goes under
    /usr/share/doc/<package_name>-<version>

For the pear package, the installer copy doc files to
    %{pear_docdir} = /usr/share/pear/doc/<extension_name>

So two solutions

1/ It's ok to keep this file here and use
    %doc %{pear_docdir}/foo

2/ It's not ok, we MUST move them to /usr/share/doc ?

Actually, most pear package apply 2

I'm asking this because a new package under review apply 1
https://bugzilla.redhat.com/show_bug.cgi?id=551724

And an (old) bug is open against php-pear
https://bugzilla.redhat.com/show_bug.cgi?id=468255

But I don't find any usefull information in Guidelines.

Regards.

P.S. please also note that, because of 2 being applied on most packages,
the result of "pear list-files foo" is not correct

[Pierre-Yves Chibon]

On Sat, 2010-01-30 at 18:27 +0100, Remi Collet wrote:
> 1/ It's ok to keep this file here and use
>         %doc %{pear_docdir}/foo

This is the solution used in the R packages.

Pierre