[Fedora-packaging] New autogenerated documentation guideline proposal

[Toshio Kuratomi]

On Fri, Aug 06, 2010 at 11:21:48AM +0800, Chen Lei wrote:
> 2010/8/6 seth vidal <skvidal at fedoraproject.org>:
> > On Thu, 2010-08-05 at 21:13 -0400, Braden McDaniel wrote:
> >> >   These packages also tend to have loads
> >> > of small files (root-doc has over 20,000), all of which end up in
> >> > filelists.xml, which then get processed by yum when it needs complete
> >> > filelists.
> >>
> >> To the extent that this sort of thing is a real *general* problem, it
> >> needs to be solved on the yum side.
> >
> > Agreed. It may become a target feature for f15- but it will involve
> > changing the format of the repodata and that will be invasive.
> >
> >
> > -sv
> 
> At least, we should not ship apidocs for normally desktop program(e.g.
> gedit) and not ship duplicate format docs(e.g. shipping html pdf doc
> in the same package), personally I like html docs better than doc/pdf.
> 
> I suggest to disscuss extreme big auto-generated apidocs(size > 100M)
> rpm case by case, it'll be better to determine whether shipping it or
> not by FESCo. I think only popular libraries are worth to ship a big
> -doc subpackage, other library packages should not enable generate big
> doc subpackage by default, user who really need those docs can
> generate -doc subpackage by running 'rpmbuild -bb with...'.
> 
I'm much more in favor of leaving this up to the package maintainers than to
have FESCo decide.

-Toshio
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: not available
Url : http://lists.fedoraproject.org/pipermail/packaging/attachments/20100806/58267351/attachment.bin