[Fedora-packaging] 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