Re: New autogenerated documentation guideline proposal

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

 



 On 08/05/2010 10:21 PM, Chen Lei wrote:
> 2010/8/6 seth vidal <skvidal@xxxxxxxxxxxxxxxxx>:
>> 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...'.
>
> Regards,
> Chen Lei
> --
> packaging mailing list
> packaging@xxxxxxxxxxxxxxxxxxxxxxx
> https://admin.fedoraproject.org/mailman/listinfo/packaging
>
How about a docs repo seperate from standard repos so end users could
disable that repo if they don't want it.

Just a thought.

Carl Thompson

--
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