[libvirt] [PATCH] spec: Only distribute ChangeLog in -devel package

[Eric Blake]

On 09/04/2013 09:11 AM, Daniel P. Berrange wrote:

>> client: COPYING COPYING.LESSER
>> daemon: none
>> other[*]: AUTHORS ChangeLog.gz NEWS README TODO
>>
>> where I have yet another question: should the other package be
>> libvirt-docs or libvirt-devel?  Your patch put them in devel, but I
>> think docs might be a better fit.
> 
> Oh, I didn't realize we had a -docs package. I just looked at
> -devel and saw the website docs and didn't look further. It
> seems we're duplicating website in both -docs and -devel
> which is bad. We should remove those website docs from -devel
> and have all docs related stuff in -docs

Duplication is indeed bad.  But notice this guideline:

https://fedoraproject.org/wiki/Packaging:Guidelines?rd=Packaging/Guidelines#Documentation

Any relevant documentation included in the source distribution should be
included in the package as %doc. Irrelevant documentation include build
instructions, the omnipresent INSTALL file containing generic build
instructions, for example, and documentation for non-Linux systems, e.g.
README.MSDOS. Pay also attention about which subpackage you include
documentation in, for example API documentation belongs in the -devel
subpackage, not the main one. Or if there's a lot of documentation,
consider putting it into a subpackage. In this case, it is recommended
to use *-doc as the subpackage name, and Documentation as the value of
the Group tag.

I'm wondering if the API docs should live in -devel, and all other files
in -docs; or we could just have ALL docs live in -docs, as well as make
-devel depend on -docs.

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 621 bytes
Desc: OpenPGP digital signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20130904/a188ed10/attachment-0001.sig>