Re: Should {NEWS, CHANGELOG, README, etc} go into main package or -doc subpackage?

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Mon, 10 Sep 2012 15:46:18 +0200, Vít Ondruch wrote:

> Hi,
> 
> Can somebody clarify where should go the files mentioned in $SUBJECT if 
> the package provides a -doc subpackage? It is obvious that the LICENSE 
> file must go into the main package, but what about the others? There are 
> packages, which has the $SUBJECT files in main package, but I think they 
> should go into -doc subpackage. What else wold be the -doc subpackage 
> purpose then?
> 
> BTW it would be nice if the guidelines could be clarified regarding this 
> issue.

A -doc subpackage is justified to split off _huge_ documentation in order
to reduce the size of an installation, spin, or -devel pkg depchain.
The purpose of -doc packages is not to strip off all documentation of
packages.

Small doc files, such as those you mention (also NEWS, AUTHORS), may be nice
to have available always together with the software - whereas large books or
generated API HTML trees for developers may be considered more optional.

-- 
Fedora release 18 (Spherical Cow) - Linux 3.6.0-0.rc4.git2.1.fc18.x86_64
loadavg: 0.55 0.18 0.10
--
packaging mailing list
packaging@xxxxxxxxxxxxxxxxxxxxxxx
https://admin.fedoraproject.org/mailman/listinfo/packaging



[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite Forum]     [KDE Users]

  Powered by Linux