From 72d1435f20e47339c75ee8dcb8adecbb2bc7516b Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <srifenbark@gmail.com>
Date: Wed, 7 Sep 2016 10:17:42 -0700
Subject: documentation: Added new description for the PACKAGECONFIG_CONFARGS
 variable.

Fixes [YOCTO #10183]

Added a new variable entry for the PACKAGECONFIG_CONFARGS variable.

With the introduction of the new PACKAGECONFIG_CONFARGS variable,
many places in the mainstream YP documentation that referenced
how to pass configure arguments using EXTRA_OECONF needed to also
make mention of this new variable.  I added many cross-references
to the new variable.

(From yocto-docs rev: 00f02d45319bab90b72eab89fcb69cbe8bd05bb5)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 documentation/sdk-manual/sdk-extensible.xml | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

(limited to 'documentation/sdk-manual')

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
                     <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_OEMAKE'><filename>EXTRA_OEMAKE</filename></ulink>
-                    within the recipe as follows:
+                    or
+                    <ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGECONFIG_CONFARGS'><filename>PACKAGECONFIG_CONFARGS</filename></ulink>
+                    within the recipe.
+                    Here is an example using <filename>EXTRA_OEMAKE</filename>:
                     <literallayout class='monospaced'>
      EXTRA_OEMAKE += "'CC=${CC}' 'CXX=${CXX}'"
                     </literallayout>
@@ -1062,9 +1065,12 @@
             then a fixed set of arguments is passed to it to enable
             cross-compilation plus any extras specified by
             <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_OECONF'><filename>EXTRA_OECONF</filename></ulink>
+            or
+            <ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGECONFIG_CONFARGS'><filename>PACKAGECONFIG_CONFARGS</filename></ulink>
             set within the recipe.
             If you wish to pass additional options, add them to
-            <filename>EXTRA_OECONF</filename>.
+            <filename>EXTRA_OECONF</filename> or
+            <filename>PACKAGECONFIG_CONFARGS</filename>.
             Other supported build tools have similar variables
             (e.g.
             <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_OECMAKE'><filename>EXTRA_OECMAKE</filename></ulink>
@@ -1072,8 +1078,9 @@
             <ulink url='&YOCTO_DOCS_REF_URL;#var-EXTRA_OESCONS'><filename>EXTRA_OESCONS</filename></ulink>
             for Scons, and so forth).
             If you need to pass anything on the <filename>make</filename>
-            command line, you can use <filename>EXTRA_OEMAKE</filename> to do
-            so.
+            command line, you can use <filename>EXTRA_OEMAKE</filename> or the
+            <ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGECONFIG_CONFARGS'><filename>PACKAGECONFIG_CONFARGS</filename></ulink>
+            variables to do so.
         </para>
 
         <para>
@@ -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
-            <filename>EXTRA_OECONF</filename>.
+            <filename>EXTRA_OECONF</filename> or
+            <filename>PACKAGECONFIG_CONFARGS</filename>.
             If applicable, the command also shows you the output of the
             configure script's "&dash;&dash;help" option as a reference.
         </para>
-- 
cgit v1.2.3-54-g00ecf