10523 2016-10-28 12:25:58 +0000 api-documentation DISTRO_FEATURE should be enabled and tested on at least one build configuration 2016-12-06 17:26:27 +0000 1 1 5 Infrastructure AutoBuilder autobuilder 2.3 x86 Multiple RESOLVED FIXED Medium+ normal 2.3 M1 1 alex.kanavin joshuagloe infras.ab.watcher Infras.watcher jose.perez.carranza meta.mr.watcher meta.watcher pidge ross.burton juan.fernandox.ramos.frayle --- --- Yes (doc changes required) oldest_to_newest 67721 0 alex.kanavin 2016-10-28 12:25:58 +0000 See https://bugzilla.yoctoproject.org/show_bug.cgi?id=8584 for why this needs to be a site configuration change instead of being enabled by default (or enforced) in poky. 67851 1 bluelightning 2016-11-02 02:37:44 +0000 It sounds like we've decided against enabling this for the SDK images we build due to the size increase. If that's the cae, why do we want to do it by default for our SDKs? 67857 2 ross.burton 2016-11-02 12:25:48 +0000 Not doing it for the SDKs because it blows up the AB is one thing - the core-image-lsb-sdk has always been close to the maximum size and for example the piglit upgrade also caused it to get too large for hddimg. I'd be reasonable happy with a compromise that SDK images and (E)SDK tarballs include doc-pkgs if they are present, so that simply turning on the api-documentation distro feature adds the documentation. We can not do that for Poky out of the box, but we probably should have at least one run on the AB somewhere to verify regressions. I do think we need numbers for the size increase - how much does the SDK grow by when documentation is enabled, and are there any simple ways to reduce that size if it is too much. Compressed manpages, unexpected files in the documentation that can be removed, etc (in this case, a SDK image is likely an easier target to iterate on). 67872 3 alex.kanavin 2016-11-02 16:57:43 +0000 I have the numbers now. The core-image-lsb-sdk image without the docs is 3982025728 bytes, with the docs it's 4399133696 bytes. After compression, it's 583615440 and 633771939 bytes respectively. The difference is 417107968 bytes, or 50156499 bytes when compressed. This doesn't seem so bad to me, so I'll make a patch to add the doc-pkgs to SDKs if api-documentation is in DISTRO_FEATURES. As for SDK images, that won't happen until we slim them down well below 4 gigabytes (which triggers an AB failure because of FAT limitations). 68208 4 ross.burton 2016-11-09 22:37:59 +0000 Alex's patch landed in oe-core d2b7b3fca328449cd87997be7f897b59433a153d. The one remaining task is to exercise the documentation build on the AB somehow. It's a distro feature that we haven't (yet) enabled by default in oe-core nodistro or poky due to the build time overhead, but it does need testing. I guess the options are 1) add a new build set nightly-apidocs that tweaks the distro feature 2) add api-documentation to poky-lsb 3) something else? 68210 5 ross.burton 2016-11-10 10:29:32 +0000 Richard suggested: 3) add to nightly-qa-extras This seems like a good idea to me. 68438 6 joshuagloe 2016-11-18 13:10:09 +0000 Ross submitted a patch to add an api-documentation build to nightly-qa-extras: https://lists.yoctoproject.org/pipermail/yocto/2016-November/033052.html