Red Hat Bugzilla – Bug 783483
Review Request: kdelibs-apidocs - KDELibs API documentation
Last modified: 2012-01-31 18:34:48 EST
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
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.
That's not a blocker for 4.8.
Unfortunately, I realized we are stepping on a licensing mine here, and spot confirmed it:
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.
Can somebody please open an upstream bug and add it as external reference?
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)