For now, doc provided in pear package use an awful hack.
Standard pear installation copy doc in /usr/share/pear/doc (known as %{pear_docdir} in spec file)
After installation they are moved to a temporary location Something like mv %{buildroot}%{pear_docdir}/%{pear_name} docdir
And then add to %file as %doc %doc docdir/* This seems awful for (at least) 2 reasons: - PHP developer are used to search them in /usr/share/pear/doc - report of "pear list-files <package>" is wrong
Proposal :
- keep documentation in standard pear location
- tag them as doc files %doc %{pear_docdir}/%{pear_name}
- add a README-DOCS-RPM in standard "fedora" location Documentation for %{pear_name} are in %{pear_docdir}/%{pear_name}
Other tried solutions
- soft link => will be impossible to handle update (from file to link) for all existing packages
- overriding "doc_dir" in pear configuration before install => file list don't store full patch, but path relative to config so, this won't work, path must be the same for all packageq
Any comment ? Others idea ?
I will submit a draft for a PHP Guidelines update quite soon.
Remi.
P.S. for now, /usr/share/pear/doc only contains doc from php-pear main package, this is an exception which probably need to be fixed according to the Guidelines, if approved.
On Mon, Nov 8, 2010 at 17:58, Remi Collet Fedora@famillecollet.com wrote:
Proposal :
keep documentation in standard pear location
tag them as doc files
%doc %{pear_docdir}/%{pear_name}
- add a README-DOCS-RPM in standard "fedora" location
Documentation for %{pear_name} are in %{pear_docdir}/%{pear_name}
I don't think we need the /usr/share/docs/php-[channel]-* directories at all. One README-DOCS-RPM in /usr/share/docs/php-pear-[current] should be enough to point everyone in the correct direction.
packaging@lists.fedoraproject.org