Re: New autogenerated documentation guideline proposal

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

 



On Thu, 2010-08-05 at 22:04 +0300, Jonathan Dieter wrote: 
> I'm proposing a new guideline, that autogenerated documentation must be
> a reasonable size.  The reason for this guideline is that there are a
> number of packages in the repository with automatically generated
> documentation that is *far* bigger than the package itself.
> 
> Some examples:
> antlr3  - src rpm size:  1.5MB - antlr3-C-doc rpm size:      56MB
> cloudy  - src rpm size: 23.0MB - cloudy-devel-doc rpm size: 110MB
> kdelibs - src rpm size: 13.9MB - kdelibs-apidocs rpm size:  283MB
> mrpt    - src rpm size: 34.7MB - mrpt-doc rpm size:         252MB
> xrootd  - src rpm size:  1.7MB - xrootd-doc rpm size:       104MB
> 
> and, my all-time favorite (which sparked this whole thing):
> root    - src rpm size: 27.8MB - root-doc rpm size:         687MB
> 
> This isn't only a size problem.

You haven't said why size is a problem in the first place.  Are we
trying to limit the total size of Fedora packages? (To what?)

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

-- 
Braden McDaniel <braden@xxxxxxxxxxxxx>

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