Bug 492439

Summary: Please split documentation into perl-doc subpackage
Product: [Fedora] Fedora Reporter: Lubomir Rintel <lkundrak>
Component: perlAssignee: Stepan Kasal <kasal>
Status: CLOSED NOTABUG QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: medium Docs Contact:
Priority: low    
Version: rawhideCC: kasal, mmahut, mmaslano, rc040203, robin.norwood, tcallawa
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2009-03-27 18:57:36 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 492424    

Description Lubomir Rintel 2009-03-26 20:01:18 UTC
Hi,

Package's documentation is over 1 MB (perl-5.10.0, 2448 kbytes). Creating a -doc subpackage and moving the documentation files there would save considerable space on the live media.

Thanks in advance!

Comment 1 Marcela Mašláňová 2009-03-27 14:01:00 UTC
In case we should be splitting our packages with bigger doc, then it should be  added into packaging guidelines after discussion on fedora-devel and probably also on FESCO meeting.

Comment 2 Ralf Corsepius 2009-03-27 17:43:46 UTC
FWIW: I am opposed to splitting out the perl-docs.

(In reply to comment #1)
> In case we should be splitting our packages with bigger doc, then it should be 
> added into packaging guidelines after discussion on fedora-devel and probably
> also on FESCO meeting.  

w/ my FPC-member-hat on:

* The current rule can be summarized as "put all documentation into the package containing the components a document is documenting".
Wrt. this rule, the perl package has deficiencies. Whether addressing them makes sense/is worth it, is a separate problem (IMO, it's not worth it).

* The FPG's recommendation to split out larger docs into separate *-doc packages originates from  packaging "optional docs", e.g. html formated docs.
AFAIS, the current perl package (I only checked FC10) doesn't contain such documents.

* Adding a separate *-doc package for perl adds further packages deps, which further complicates the already complex packaging of perl.

* Technically, separate *-docs packages are not necessary.

Comment 3 Stepan Kasal 2009-03-27 18:57:36 UTC
(In reply to comment #0)
> Package's documentation is over 1 MB (perl-5.10.0, 2448 kbytes). Creating a
> -doc subpackage and moving the documentation files there would save
> considerable space on the live media.

Actually, the documetation files in perl.rpm occupy about 9 MB:
- %{_docdir}/perl-5.10.0/ occupies 2.5 MB
- perl manual pages occupy 6.6 MB

The description of this bug mentiones the former; since it is a compressed version of almost 11 MB of change log text, it should go away.  I moved it to perl-devel, details in bug #492605.

For the latter, I second Ralf's comment #2: --excludedocs is your friend.

According to my private communication with the reporter, the fix for #492605 actually solves his issue; yet I'm setting the resolution to NOTABUG indicating that it is preferable not to split the package.