Bug 7755

Summary: Document UNKNOWN_CONFIGURE_WHITELIST
Product: [Documentation] Reference Reporter: Paul Eggleton <bluelightning>
Component: handbookAssignee: Scott Rifenbark <srifenbark>
Status: VERIFIED FIXED QA Contact: Bogdan Alexandru Voiculescu <bogdanx.a.voiculescu>
Severity: enhancement    
Priority: Low CC: bluelightning, bogdanx.a.voiculescu, poky.doc.watcher, poky.watcher, ross.burton, srifenbark
Version: unspecified   
Target Milestone: 1.9 M1   
Hardware: All   
OS: Multiple   
Whiteboard: 25 May 2015: IN PROGRESS REVIEW
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: Done (doc changes complete)

Description Paul Eggleton 2015-05-13 15:17:13 UTC
Add UNKNOWN_CONFIGURE_WHITELIST to the variable reference in the ref manual. The description should be something like:

Specifies a list of options that, if reported by the configure script as being invalid, should not generate a warning during do_configure. Normally, invalid configure options should simply not be passed to the configure script at all (e.g. should be removed from EXTRA_OECONF), but there are for example common options we pass to all configure scripts at a class level that may not be valid for some configure scripts, and there is no benefit to seeing a warning about these - in which case they are added to UNKNOWN_CONFIGURE_WHITELIST.
Comment 1 Ross Burton 2015-05-13 20:51:11 UTC
My name is Ross Burton and I endorse Paul's proposed paragraph.

Probably worth mentioning that the test is part of insane.bbclass, but only enabled if the recipe inherits autotools.bbclass.
Comment 2 Scott Rifenbark 2015-05-26 22:32:23 UTC
Hi, 

Here is a link to the variable.  Please review it and give me any feedback for corrections.  I was a bit unsure about the part Ross added.  Not sure what "test" really means here.  So, the wording might need adjustment for that part.

http://www.yoctoproject.org/docs/1.9/ref-manual/ref-manual.html#var-UNKNOWN_CONFIGURE_WHITELIST

Thanks,
Scott
Comment 3 Ross Burton 2015-06-01 09:24:05 UTC
"test" meant the code that looks at the log output and uses WHITELIST.  Maybe a clearer wording would be:

"The configure arguments check that uses UNKNOWN_CONFIGURE_WHITELIST is part of the insane class [continue as before]".

Apart from that, looks good, thanks Scott.
Comment 4 Scott Rifenbark 2015-06-01 15:21:52 UTC
Ross, 

See http://www.yoctoproject.org/docs/1.9/ref-manual/ref-manual.html#var-UNKNOWN_CONFIGURE_WHITELIST for the change.

Thanks, 
Scott
Comment 5 Ross Burton 2015-06-01 15:39:58 UTC
Looks good.
Comment 6 Scott Rifenbark 2015-06-01 15:41:45 UTC
Thanks Ross, 

I am setting the doc flag to "done".

Scott
Comment 7 Bogdan Alexandru Voiculescu 2015-09-03 08:59:12 UTC
verified in documentation