diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 9b0015d2ee..74deac5452 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -2297,6 +2297,8 @@
However, you might still want to make some adjustments.
For example, you can set
EXTRA_OECONF
+ or
+ PACKAGECONFIG_CONFARGS
to pass any needed configure options that are specific
to the recipe.
CMake:
@@ -3011,8 +3013,10 @@
You do not need to add a do_compile step since by default BitBake
starts the make command to compile the application.
If you need additional make options, you should store them in the
- EXTRA_OEMAKE
- variable.
+ EXTRA_OEMAKE
+ or
+ PACKAGECONFIG_CONFARGS
+ variables.
BitBake passes these options into the GNU make invocation.
Note that a do_install task is still required.
Otherwise, BitBake runs an empty do_install task by default.
diff --git a/documentation/ref-manual/closer-look.xml b/documentation/ref-manual/closer-look.xml
index 825409f5a7..a9eb1b6c7f 100644
--- a/documentation/ref-manual/closer-look.xml
+++ b/documentation/ref-manual/closer-look.xml
@@ -888,7 +888,9 @@
class,
you can add additional configuration options by using
the EXTRA_OECONF
- variable.
+ or
+ PACKAGECONFIG_CONFARGS
+ variables.
For information on how this variable works within
that class, see the
meta/classes/autotools.bbclass file.
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index 98a365871d..2344a0406a 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -161,13 +161,17 @@
cross-compilation.
You can pass additional parameters to
configure through the
- EXTRA_OECONF variable.
+ EXTRA_OECONF
+ or
+ PACKAGECONFIG_CONFARGS
+ variables.
do_compile -
Runs make with arguments that specify the
compiler and linker.
You can pass additional arguments through
- the EXTRA_OEMAKE variable.
+ the EXTRA_OEMAKE
+ variable.
do_install -
Runs make install and passes in
@@ -3726,7 +3730,9 @@
software that uses the Waf build system.
You can use the
EXTRA_OECONF
- variable to specify additional configuration options to be passed on
+ or
+ PACKAGECONFIG_CONFARGS
+ variables to specify additional configuration options to be passed on
the Waf command line.
diff --git a/documentation/ref-manual/ref-qa-checks.xml b/documentation/ref-manual/ref-qa-checks.xml
index 4fcf1db619..893629d698 100644
--- a/documentation/ref-manual/ref-qa-checks.xml
+++ b/documentation/ref-manual/ref-qa-checks.xml
@@ -918,7 +918,8 @@ can be found then it should be implemented. I can't find one at the moment.
and the upstream change log or release notes.
Once you have worked out what the appropriate
change is, you can update
- EXTRA_OECONF
+ EXTRA_OECONF,
+ PACKAGECONFIG_CONFARGS,
or the individual
PACKAGECONFIG
option values accordingly.
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 37ca37b626..afc36a5b14 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -4037,6 +4037,10 @@
Additional configure script options.
+ See
+ PACKAGECONFIG_CONFARGS
+ for additional information on passing configure script
+ options.
@@ -9112,10 +9116,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
Extra arguments
that should be added to the configure script
argument list
- (EXTRA_OECONF)
+ (EXTRA_OECONF
+ or
+ PACKAGECONFIG_CONFARGS)
if the feature is enabled.Extra arguments
that should be added to EXTRA_OECONF
+ or PACKAGECONFIG_CONFARGS
if the feature is disabled.
Additional build dependencies
@@ -14817,7 +14824,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
task.
Normally, invalid configure options are simply not passed
to the configure script (e.g. should be removed from
- EXTRA_OECONF).
+ EXTRA_OECONF
+ or
+ PACKAGECONFIG_CONFARGS).
However, common options, for example, exist that are passed
to all configure scripts at a class level that might not
be valid for some configure scripts.
diff --git a/documentation/ref-manual/ref-varlocality.xml b/documentation/ref-manual/ref-varlocality.xml
index d3f873298d..54524d5b60 100644
--- a/documentation/ref-manual/ref-varlocality.xml
+++ b/documentation/ref-manual/ref-varlocality.xml
@@ -176,16 +176,18 @@
This section lists variables that define extra build information for recipes.
+ DEFAULT_PREFERENCE
+ EXTRA_OECMAKE
EXTRA_OECONF
EXTRA_OEMAKE
+ PACKAGECONFIG_CONFARGS
+ PACKAGES
- DEFAULT_PREFERENCE
-
diff --git a/documentation/sdk-manual/sdk-extensible.xml b/documentation/sdk-manual/sdk-extensible.xml
index c2360e9f37..86f1e28fc9 100644
--- a/documentation/sdk-manual/sdk-extensible.xml
+++ b/documentation/sdk-manual/sdk-extensible.xml
@@ -849,7 +849,10 @@
To force the value on the command line, add the
variable setting to
EXTRA_OEMAKE
- within the recipe as follows:
+ or
+ PACKAGECONFIG_CONFARGS
+ within the recipe.
+ Here is an example using EXTRA_OEMAKE:
EXTRA_OEMAKE += "'CC=${CC}' 'CXX=${CXX}'"
@@ -1062,9 +1065,12 @@
then a fixed set of arguments is passed to it to enable
cross-compilation plus any extras specified by
EXTRA_OECONF
+ or
+ PACKAGECONFIG_CONFARGS
set within the recipe.
If you wish to pass additional options, add them to
- EXTRA_OECONF.
+ EXTRA_OECONF or
+ PACKAGECONFIG_CONFARGS.
Other supported build tools have similar variables
(e.g.
EXTRA_OECMAKE
@@ -1072,8 +1078,9 @@
EXTRA_OESCONS
for Scons, and so forth).
If you need to pass anything on the make
- command line, you can use EXTRA_OEMAKE to do
- so.
+ command line, you can use EXTRA_OEMAKE or the
+ PACKAGECONFIG_CONFARGS
+ variables to do so.
@@ -1081,7 +1088,8 @@
to help you set the arguments listed in the previous paragraph.
The command determines the exact options being passed, and shows
them to you along with any custom arguments specified through
- EXTRA_OECONF.
+ EXTRA_OECONF or
+ PACKAGECONFIG_CONFARGS.
If applicable, the command also shows you the output of the
configure script's "‐‐help" option as a reference.