Bug 783483

Summary:	Review Request: kdelibs-apidocs - KDELibs API documentation
Product:	[Fedora] Fedora	Reporter:	Rex Dieter <rdieter>
Component:	Package Review	Assignee:	Nobody's working on this, feel free to take it <nobody>
Status:	CLOSED CANTFIX	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	rawhide	CC:	christoph.wickert, kevin, notting, package-review
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:	2012-01-31 22:02:11 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:	656997

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)