Bug 7755 - Document UNKNOWN_CONFIGURE_WHITELIST
Summary: Document UNKNOWN_CONFIGURE_WHITELIST
Status: VERIFIED FIXED
Alias: None
Product: Reference
Classification: Documentation
Component: handbook (show other bugs)
Version: unspecified
Hardware: All Multiple
: Low enhancement
Target Milestone: 1.9 M1
Assignee: Scott Rifenbark
QA Contact: Bogdan Alexandru Voiculescu
URL:
Whiteboard: 25 May 2015: IN PROGRESS REVIEW
Depends on:
Blocks:
 
Reported: 2015-05-13 15:17 UTC by Paul Eggleton
Modified: 2015-09-03 08:59 UTC (History)
6 users (show)

See Also:
OS type for building Yocto: ---
Type of Regression: ---
Verified:
Documentation change: Done (doc changes complete)


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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