FAQ Search Today's Posts Mark Forums Read
» Video Reviews

» Linux Archive

Linux-archive is a website aiming to archive linux email lists and to make them easily accessible for linux users/developers.

» Sponsor

» Partners

» Sponsor

Go Back   Linux Archive > Redhat > Fedora Packaging

LinkBack Thread Tools
Old 11-08-2010, 03:58 PM
Remi Collet
Default RFC before update PHP Guidelines about PEAR package documentation

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

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.


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.
packaging mailing list

Thread Tools

All times are GMT. The time now is 03:21 PM.

VBulletin, Copyright ©2000 - 2014, Jelsoft Enterprises Ltd.
Content Relevant URLs by vBSEO ©2007, Crawlability, Inc.
Copyright 2007 - 2008, www.linux-archive.org