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
%{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.
--
packaging mailing list
packaging@lists.fedoraproject.org
https://admin.fedoraproject.org/mailman/listinfo/packaging
 

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