New autogenerated documentation guideline proposal

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

 



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

The proposed guideline is at the bottom of the "Queued but unowned"
table at https://fedoraproject.org/wiki/PackagingDrafts/DraftsTodo.

I'd love it if it could be discussed and possibly voted on at the next
meeting.

Jonathan

Attachment: signature.asc
Description: This is a digitally signed message part

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