Bug 492439 - Please split documentation into perl-doc subpackage
Summary: Please split documentation into perl-doc subpackage
Keywords:
Status: CLOSED NOTABUG
Alias: None
Product: Fedora
Classification: Fedora
Component: perl
Version: rawhide
Hardware: All
OS: Linux
low
medium
Target Milestone: ---
Assignee: Stepan Kasal
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks: AstronomyTracker
TreeView+ depends on / blocked
 
Reported: 2009-03-26 20:01 UTC by Lubomir Rintel
Modified: 2009-03-27 18:57 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2009-03-27 18:57:36 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)

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.


Note You need to log in before you can comment on or make changes to this bug.