Bug 2614

Summary: Using EXTRA_IMAGE_FEATURES += "doc-pkgs" in local.conf does not install man pages
Product: [Build System, Metadata & Runtime] OE-Core Reporter: Jason Wessel <jason.wessel>
Component: configurationAssignee: Paul Eggleton <bluelightning>
Status: VERIFIED FIXED QA Contact:
Severity: enhancement    
Priority: Low CC: bluelightning, laurentiu.serban, sgw, song.liu
Version: 1.2.1   
Target Milestone: 1.3 M3   
Hardware: x86   
OS: Multiple   
Whiteboard: (p1)
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: ---

Description Jason Wessel 2012-06-17 01:12:21 UTC
Add the following to the local.conf:
    EXTRA_IMAGE_FEATURES += "doc-pkgs"

It is expected that this will install all the -doc packages to the target file system, much like adding "dbg-pkgs" would add the debug-info packages to the target file system.

It does not appear as if the if the doc-pkgs is plumbed all the way throught the RECOMMENDS... in the same manner as the dbg-pkgs and dev-pkgs.
Comment 1 Song Liu 2012-07-04 20:20:04 UTC
RFC patches need rework, moving to M3. Will be done early M3
Comment 2 Paul Eggleton 2012-07-11 13:04:52 UTC
Patches are now out on the OE-core list for review on this one (for merging into M3 rather than M2).
Comment 3 Paul Eggleton 2012-07-31 14:07:23 UTC
Implemented in the following commits:

fa5640d143beea4be101d6622d3fa133d04272f2
22965c47152c801fada815e0b165050e8e7f9549
ad63b9b11b4c42414ff2c180dd03c1a7283321ec
Comment 4 Paul Eggleton 2012-08-06 15:00:03 UTC
Addendum: the following fix was just merged to avoid errors installing locale packages for recipes that remove PN from PACKAGES after the above fixes (affecting gcc-runtime):

06ad59cca92f58d4eefa42b532a778f3b83c66a1
Comment 5 Laurentiu Serban 2012-08-18 23:20:55 UTC
Hello Paul,
I am reopening this are there are no doc packages installed for core-image-sato when using the option from the description.

If there is another way to test or my test is invalid, please let me know.
Laurentiu
Comment 6 Paul Eggleton 2012-08-19 18:15:15 UTC
Hi Laurentiu, I just tested it here and it worked perfectly - I did nothing more than adding EXTRA_IMAGE_FEATURES += "doc-pkgs" to my conf/local.conf and then bitbake core-image-sato. Some questions:

1) How are you verifying that no doc packages are installed?
2) Which packaging backend are you using?
3) Is doc-pkgs listed when you run the following command:

 bitbake -e core-image-sato | grep ^IMAGE_FEATURES
Comment 7 Laurentiu Serban 2012-08-20 14:45:03 UTC
Hello Paul,
Although I added the line     EXTRA_IMAGE_FEATURES += "doc-pkgs"
in the local.conf
the output of bitbake -e core-image-sato is 

lserban@computer2:~/work/master/build$ bitbake -e core-image-sato | grep IMAGE_FEATURES | grep EXTRA
# EXTRA_IMAGE_FEATURES=debug-tweaks
EXTRA_IMAGE_FEATURES="debug-tweaks"

What is interesting is that the doc packages are built but not added to the image.
The packages are rpm
Comment 8 Laurentiu Serban 2012-08-20 14:51:23 UTC
Found the issue,
There was another EXTRA_IMAGE_FEATURES +=Xxxx overwriting the initial one.
I will retested and change the state.
Comment 9 Paul Eggleton 2012-08-20 15:00:00 UTC
Right, that would explain it (although it would need to be = and not += to have behaved in the way described).

FYI, to answer your other comment, the doc packages are always produced by default for any recipe which installs files into documentation directories (see the value of FILES_${PN}-doc in meta/conf/bitbake.conf). Not all packages do this however. This is independent of whether the doc packages get installed into the image.
Comment 10 Laurentiu Serban 2012-08-20 15:03:00 UTC
Thank you for the info Paul
I will close this
Comment 11 Laurentiu Serban 2012-08-20 15:03:21 UTC
Setting to verified
Comment 12 Paul Eggleton 2012-09-05 17:53:26 UTC
For reference, I missed noting one more change that is required for this functionality to work - poky revision 5334a93d261598757ccce48a78b8ba2b7e5806f3.