Bug 783483 - Review Request: kdelibs-apidocs - KDELibs API documentation
Summary: Review Request: kdelibs-apidocs - KDELibs API documentation
Keywords:
Status: CLOSED CANTFIX
Alias: None
Product: Fedora
Classification: Fedora
Component: Package Review
Version: rawhide
Hardware: All
OS: Linux
medium
medium
Target Milestone: ---
Assignee: Nobody's working on this, feel free to take it
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks: kde-reviews
TreeView+ depends on / blocked
 
Reported: 2012-01-20 15:32 UTC by Rex Dieter
Modified: 2012-01-31 23:34 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-01-31 22:02:11 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)

Description Rex Dieter 2012-01-20 15:32:14 UTC
Spec URL: http://rdieter.fedorapeople.org/rpms/kdelibs-apidocs/kdelibs-apidocs.spec
SRPM URL: http://rdieter.fedorapeople.org/rpms/kdelibs-apidocs/kdelibs-apidocs-4.7-1.20120118.fc16.src.rpm
Description:
This package includes the KDELibs 4 API documentation in HTML
format for easy browsing.


This is currently (re)generated as part of every kdelibs build, wasting resources on builders, infrastructure, and mirrors.  We'll instead package this largish package separately, using upstream pregenerated documentation.

Comment 1 Kevin Kofler 2012-01-25 21:26:22 UTC
That's not a blocker for 4.8.

Comment 2 Kevin Kofler 2012-01-31 22:02:11 UTC
Unfortunately, I realized we are stepping on a licensing mine here, and spot confirmed it:
http://lists.fedoraproject.org/pipermail/legal/2012-January/001802.html
so this plan doesn't look viable.

The license that applies here is the GPL, not the FDL (because the apidocs are generated from GPLed and/or LGPLed code and there is no binding statement anywhere which would make another license apply), and the GPL requires that we ship the exact corresponding source code for the pregenerated documentation.

Comment 3 Christoph Wickert 2012-01-31 23:14:29 UTC
Can somebody please open an upstream bug and add it as external reference?

Comment 4 Rex Dieter 2012-01-31 23:34:48 UTC
In short, looks like there's not much that can be done.  As-is, the archives at api.kde.org are not redistributable and my irc chatting with upstream sounded like they didn't have much interest in efforts to address it (generally, by recording which scm source commits were used to generate the docs)


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