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

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/Guidelin... 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.