<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>10642</bug_id>
          
          <creation_ts>2016-11-10 22:27:33 +0000</creation_ts>
          <short_desc>BUILD_CC and such are missing from variable index</short_desc>
          <delta_ts>2017-08-31 21:38:34 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Reference</product>
          <component>handbook</component>
          <version>unspecified</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>31 August 2017: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Yann Dirson">ydirson</reporter>
          <assigned_to name="Kristi">kristi</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>randy.macleod</cc>
    
    <cc>srifenbark</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Done (doc changes complete)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>68228</commentid>
    <comment_count>0</comment_count>
    <who name="Yann Dirson">ydirson</who>
    <bug_when>2016-11-10 22:27:33 +0000</bug_when>
    <thetext>BUILD_CFLAGS and friends are there, but _CC, _CXX and surely others are not.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>68232</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-11-11 00:12:56 +0000</bug_when>
    <thetext>Hi,

So I am assuming you mean specifically the BUILD_CC and BUILD_CXX variables.  Can you list the others for me?

Thanks,
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>68703</commentid>
    <comment_count>2</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-11-30 00:05:51 +0000</bug_when>
    <thetext>Setting to 2.3 M4.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>69766</commentid>
    <comment_count>3</comment_count>
    <who name="Randy MacLeod">randy.macleod</who>
    <bug_when>2017-01-12 16:58:28 +0000</bug_when>
    <thetext>Scott, yes, he means BUILD_CC and BUILD_CXX as described in:

http://lists.openembedded.org/pipermail/openembedded-core/2016-August/125515.html

The full set, based on master as of:
   acce512 selftest/devtool: update test to work with new mtd-utils
is:

$ grep BUILD_ meta/classes/native.bbclass
PACKAGE_ARCH = &quot;${BUILD_ARCH}&quot;
TARGET_ARCH = &quot;${BUILD_ARCH}&quot;
TARGET_OS = &quot;${BUILD_OS}&quot;
TARGET_VENDOR = &quot;${BUILD_VENDOR}&quot;
TARGET_PREFIX = &quot;${BUILD_PREFIX}&quot;
TARGET_CC_ARCH = &quot;${BUILD_CC_ARCH}&quot;
TARGET_LD_ARCH = &quot;${BUILD_LD_ARCH}&quot;
TARGET_AS_ARCH = &quot;${BUILD_AS_ARCH}&quot;
TARGET_CPPFLAGS = &quot;${BUILD_CPPFLAGS}&quot;
TARGET_CFLAGS = &quot;${BUILD_CFLAGS}&quot;
TARGET_CXXFLAGS = &quot;${BUILD_CXXFLAGS}&quot;
TARGET_LDFLAGS = &quot;${BUILD_LDFLAGS}&quot;
HOST_ARCH = &quot;${BUILD_ARCH}&quot;
HOST_OS = &quot;${BUILD_OS}&quot;
HOST_VENDOR = &quot;${BUILD_VENDOR}&quot;
HOST_PREFIX = &quot;${BUILD_PREFIX}&quot;
HOST_CC_ARCH = &quot;${BUILD_CC_ARCH}&quot;
HOST_LD_ARCH = &quot;${BUILD_LD_ARCH}&quot;
HOST_AS_ARCH = &quot;${BUILD_AS_ARCH}&quot;
CPPFLAGS = &quot;${BUILD_CPPFLAGS}&quot;
CFLAGS = &quot;${BUILD_CFLAGS}&quot;
CXXFLAGS = &quot;${BUILD_CXXFLAGS}&quot;
LDFLAGS = &quot;${BUILD_LDFLAGS}&quot;
export CC = &quot;${BUILD_CC}&quot;
export CXX = &quot;${BUILD_CXX}&quot;
export FC = &quot;${BUILD_FC}&quot;
export CPP = &quot;${BUILD_CPP}&quot;
export LD = &quot;${BUILD_LD}&quot;
export CCLD = &quot;${BUILD_CCLD}&quot;
export AR = &quot;${BUILD_AR}&quot;
export AS = &quot;${BUILD_AS}&quot;
export RANLIB = &quot;${BUILD_RANLIB}&quot;
export STRIP = &quot;${BUILD_STRIP}&quot;
export NM = &quot;${BUILD_NM}&quot;

And in case it matters to you here&apos;s the exported list:

$ grep BUILD_ meta/classes/native.bbclass | grep export
export CC = &quot;${BUILD_CC}&quot;
export CXX = &quot;${BUILD_CXX}&quot;
export FC = &quot;${BUILD_FC}&quot;
export CPP = &quot;${BUILD_CPP}&quot;
export LD = &quot;${BUILD_LD}&quot;
export CCLD = &quot;${BUILD_CCLD}&quot;
export AR = &quot;${BUILD_AR}&quot;
export AS = &quot;${BUILD_AS}&quot;
export RANLIB = &quot;${BUILD_RANLIB}&quot;
export STRIP = &quot;${BUILD_STRIP}&quot;
export NM = &quot;${BUILD_NM}&quot;


Let me know if you need anything else.

../Randy</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>69917</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2017-01-18 23:47:47 +0000</bug_when>
    <thetext>Randy, 

Thanks for the grep list.  So, these are currently documented in the YP Reference Manual&apos;s Glossary:

BUILD_ARCH
BUILD_CFLAGS
BUILD_PPFLAGS
BUILD_CXXFLAGS
BUILD_LDFLAGS
BUILD_OPTIMIZATOIN
BUILD_OS
BUILD_PREFIX
BUILD_SYS
BUILD_VENDOR

I have a couple questions:

 1. Do we need to document all the variables in the grep list?  In the past, 
    we have made decisions to not document some variables.  Paul Eggleton has
    helped determine these things in the past.

 2. BUILD_OPTIMIZATION and BUILD_SYS are currently documented but did not 
    show up in the grep list.  Are they gone now?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>72721</commentid>
    <comment_count>5</comment_count>
    <who name="Randy MacLeod">randy.macleod</who>
    <bug_when>2017-04-20 14:02:17 +0000</bug_when>
    <thetext>1.
I think we can limit the list of variables to document using some judgment.
If we assume that the reader has some development experience, then we don&apos;t need to document the _CC, _CXX, _AR, _CPP, _AR, _AS ones if we say that this variable codifies (?) standard Linux compiler and linker tools. I didn&apos;t know what _FC was, it&apos;s the FORTRAN compiler, so that might be worth pointing out even if we don&apos;t really use it very much if at all. It&apos;s define as:
   meta/conf/bitbake.conf:export BUILD_FC = &quot;${CCACHE}${BUILD_PREFIX}gfortran ${BUILD_CC_ARCH}&quot;


2.BUILD_OPTIMIZATION is no longer used by meta/classes/native.bbclass, err actually I don&apos;t think it ever was. It is still defined in:
   meta/conf/bitbake.conf:BUILD_OPTIMIZATION
as:
   &quot;-O2 -pipe&quot;
so I guess we should document it.

BUILD_SYS is still defined in:
   meta/conf/bitbake.conf
as:
   BUILD_SYS = &quot;${BUILD_ARCH}${BUILD_VENDOR}-${BUILD_OS}&quot;

As you can see in the line above, there are tonnes of BUILD_ variables so
I&apos;d just document some of the ones listed above for 2.3 and we&apos;ll see if anyone needs more info.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>72731</commentid>
    <comment_count>6</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2017-04-20 15:29:38 +0000</bug_when>
    <thetext>
Thanks Randy, 

I need to make sure I have a good list before doing this.  This is my understanding from your Comment 5:

These three variables need full-blown descriptions.

BUILD_CC_ARCH - Yes
BUILD_LD_ARCH - Yes
BUILD_AS_ARCH - Yes

The following variables of the BUILD_* type are mixed on whether we want them in the manual or not.  

BUILD_CC - No
BUILD_CXX - No
BUILD_FC - Yes
BUILD_CPP - No
BUILD_LD - Yes
BUILD_CCLD - Yes
BUILD_AR - No
BUILD_AS - No
BUILD_RANLIB - Yes
BUILD_STRIP - Yes
BUILD_NM - Yes

Am I getting this right?  

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>72734</commentid>
    <comment_count>7</comment_count>
    <who name="Randy MacLeod">randy.macleod</who>
    <bug_when>2017-04-20 15:57:43 +0000</bug_when>
    <thetext>Hi Scott,

Depending on how you right the entry, I think we can just document one of:
BUILD_RANLIB - Yes
BUILD_STRIP - Yes
BUILD_NM - Yes

So document STRIP and explain that RANLIB and NM are similar wrappers.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>72869</commentid>
    <comment_count>8</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2017-04-26 18:41:35 +0000</bug_when>
    <thetext>Hi Randy, 

So this is the list for the new variables I will add to the glossary:

BUILD_CC_ARCH
BUILD_LD_ARCH
BUILD_AS_ARCH
BUILD_FC 
BUILD_LD 
BUILD_CCLD
BUILD_STRIP (note in the description that BUILD_RANLIB and BUILD_NM are
             similar wrappers)

Probably too late to get these in for the 2.3 M4 build as the 2.3 release is in RC now.  So I am putting the target to 2.4 M1.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>74648</commentid>
    <comment_count>9</comment_count>
    <who name="Randy MacLeod">randy.macleod</who>
    <bug_when>2017-06-29 15:45:34 +0000</bug_when>
    <thetext>Scott, That&apos;s fine with me. Thanks.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>74668</commentid>
    <comment_count>10</comment_count>
    <who name="Kristi">kristi</who>
    <bug_when>2017-06-29 23:32:14 +0000</bug_when>
    <thetext>Changing owner</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>75969</commentid>
    <comment_count>11</comment_count>
    <who name="Kristi">kristi</who>
    <bug_when>2017-08-17 23:18:17 +0000</bug_when>
    <thetext>Paul, 

Can you help with baseline descriptions for each? 

BUILD_CC_ARCH
BUILD_LD_ARCH
BUILD_AS_ARCH
BUILD_FC 
BUILD_LD 
BUILD_CCLD
BUILD_STRIP (note in the description that BUILD_RANLIB and BUILD_NM are
             similar wrappers)

Thanks!</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>75972</commentid>
    <comment_count>12</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2017-08-17 23:55:50 +0000</bug_when>
    <thetext>OK, here are some descriptions:


BUILD_CC_ARCH

Specifies architecture-specific C compiler flags for the build host. By default this variable&apos;s value is empty.


BUILD_LD_ARCH

Specifies architecture-specific linker flags for the build host. By default this variable&apos;s value is empty.


BUILD_AS_ARCH

Specifies architecture-specific assembler flags for the build host. By default this variable&apos;s value is empty.


BUILD_FC 

Specifies the Fortran compiler command for the build host. By default this points to gfortran with BUILD_CC_ARCH (if set) passed as arguments.


BUILD_LD

Specifies the linker command for the build host. By default this points to ld with BUILD_LD_ARCH (if set) passed as arguments.


BUILD_CCLD

Specifies the linker command to be used for the build host when the C compiler is being used as the linker. By default this points to gcc with BUILD_CC_ARCH (if set) passed as arguments.


BUILD_STRIP

Specifies the command to be used to strip debugging symbols from binaries produced for the build host. By default this points to strip.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>76304</commentid>
    <comment_count>13</comment_count>
    <who name="Kristi">kristi</who>
    <bug_when>2017-08-30 00:49:18 +0000</bug_when>
    <thetext>Thanks Paul, 

These descriptions are ready for your review: 

BUILD_CC_ARCH: http://www.yoctoproject.org/docs/2.4/ref-manual/ref-manual.html#var-BUILD_CC_ARCH

BUILD_LD_ARCH: http://www.yoctoproject.org/docs/2.4/ref-manual/ref-manual.html#var-BUILD_LD_ARCH

BUILD_AS_ARCH: http://www.yoctoproject.org/docs/2.4/ref-manual/ref-manual.html#var-BUILD_AS_ARCH

BUILD_FC: http://www.yoctoproject.org/docs/2.4/ref-manual/ref-manual.html#var-BUILD_FC

BUILD_LD: http://www.yoctoproject.org/docs/2.4/ref-manual/ref-manual.html#var-BUILD_LD

BUILD_CCLD: http://www.yoctoproject.org/docs/2.4/ref-manual/ref-manual.html#var-BUILD_CCLD

BUILD_STRIP: http://www.yoctoproject.org/docs/2.4/ref-manual/ref-manual.html#var-BUILD_STRIP

Let me know if changes need to be made. 
-Kristi</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>76307</commentid>
    <comment_count>14</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2017-08-30 04:49:48 +0000</bug_when>
    <thetext>Those look OK to me, thanks.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>76424</commentid>
    <comment_count>15</comment_count>
    <who name="Kristi">kristi</who>
    <bug_when>2017-08-31 21:38:34 +0000</bug_when>
    <thetext>Thanks Paul! Setting status to RESOLVED and putting the doc flag to &quot;Done&quot;.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>