Bug 10183

Hi, 

Based on the commit, I am proposing this draft for the PACKAGECONFIG_CONFARGS variable description in the glossary.  You should probably check it out here and provide corrections, additions, etc. before I apply it.

Also, is it safe to apply this description to the "latest" version of the documentation?  Is the new variable merged and available in poky/master?

I feel there could be more detail in my description so please help me add it.  Also, it would be good to have some example(s) to help illustrate how the user uses the new variable.  Finally, I am guessing on the space-separated syntax for the list of configuration options. 

Thanks, 
Scott

-------------------------

PACKAGECONFIG_CONFARGS:
  A space-separated list of configuration options generated from the 
  PACKAGECONFIG setting.  This list of options helps other classes and 
  recipes take advantage of the PACKAGECONFIG mechanism without having to 
  include options from EXTRA_OECONF.  

  For example, the following ....

      <I need some user-specific example here for PACKAGECONFIG_CONFARGS>

  For additional information, see the PACKAGECONFIG variable.

Hi,

(In reply to comment #1)
> Hi, 
> 
> Based on the commit, I am proposing this draft for the
> PACKAGECONFIG_CONFARGS variable description in the glossary.  You should
> probably check it out here and provide corrections, additions, etc. before I
> apply it.
> Also, is it safe to apply this description to the "latest" version of the
> documentation?  Is the new variable merged and available in poky/master?

It is safe to apply this to the latest version of documentation, as it is already available in the poky master branch:
 
> I feel there could be more detail in my description so please help me add
> it.  Also, it would be good to have some example(s) to help illustrate how
> the user uses the new variable.  Finally, I am guessing on the
> space-separated syntax for the list of configuration options. 
> 

The description looks fine to me.

> Thanks, 
> Scott
> 
> -------------------------
> 
> PACKAGECONFIG_CONFARGS:
>   A space-separated list of configuration options generated from the 
>   PACKAGECONFIG setting.  This list of options helps other classes and 
>   recipes take advantage of the PACKAGECONFIG mechanism without having to 
>   include options from EXTRA_OECONF.  
> 
>   For example, the following ....
> 
>       <I need some user-specific example here for PACKAGECONFIG_CONFARGS>


May be, we could consider this example from meta-qt4 : (http://git.yoctoproject.org/cgit/cgit.cgi/meta-qt4/tree/recipes-qt4/qt4/qt4-embedded.inc )


PACKAGECONFIG ??= ""
PACKAGECONFIG[tslib] = " -plugin-mouse-tslib, ,tslib"

QT_EMBEDDED_EXTRA_FLAGS ?= " \
    -plugin-gfx-transformed -plugin-gfx-qvfb -plugin-gfx-vnc \
    -qt-mouse-pc -qt-mouse-qvfb -qt-mouse-linuxinput \
    -qt-kbd-tty -qt-kbd-linuxinput ${PACKAGECONFIG_CONFARGS} \
"

There are a number of examples available in meta-qt5 as well.

https://github.com/meta-qt5/meta-qt5/commit/9dc60fe10fe812eb4d722d81351c74ec598cb114
 
>   For additional information, see the PACKAGECONFIG variable.

Hi, 

Thanks for the additional information.  I have created the variable description in the manual.  See here - http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-PACKAGECONFIG_CONFARGS

Adding this variable for the user impacted many other areas of the general YP documentation.  Every time the variable EXTRA_OEMAKE is mentioned I assume that it is valid also to mention the new PACKAGECONFIG_CONFARGS variable.  So, you should probably take a look at the following areas where I have added references and be sure that they are valid references:

 * http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#configuration-and-compilation-dev-environment - see the "do_configure" bullet.

 * http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#ref-classes-autotools - See the "do_configure" bullet.

 * http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#ref-classes-waf

 * http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#qa-errors-and-warnings - See the 27th item (error message)

 * http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-EXTRA_OECONF - I added a cross-reference here to the new variable.

* http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-PACKAGECONFIG - See steps one and two 

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

 * http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#ref-varlocality-recipe-build - Added the new variable to the list.

 * http://www.yoctoproject.org/docs/2.2/dev-manual/dev-manual.html#new-recipe-makefile-based-package

 * http://www.yoctoproject.org/docs/2.2/sdk-manual/sdk-manual.html#sdk-setting-configure-arguments - Couple instances here.

 * http://www.yoctoproject.org/docs/2.2/sdk-manual/sdk-manual.html#sdk-adding-makefile-only-software - See the third bullet item.

Moving to 2.3 M2

Implemented a while ago with no further comments.  Setting to RESOLVED and putting the doc flag to "done."

Scott