ref-manual: Updates to several variables.

I implemented some review feedback from Paul Eggleton on these
variables:

  TARGET_CFLAGS
  BUILD_OPTIMIZATION
  SDKMACHINE
  IMAGE_ROOTFS_ALIGNMENT
  IMAGE_DEVICE_TABLES
  EXTRA_IMAGECMD
  SSTATE_MIRROR_ALLOW_NETWORK
  PACKAGE_ARCHS
  SDK_PACKAGE_ARCHS

(From yocto-docs rev: 6fd804376367449494d5a5cfeb7e9bb2f4c04de1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2014-06-02 09:46:06 +03:00
committed by Richard Purdie
parent f3394914fd
commit 2aba525b98

View File

@@ -932,7 +932,7 @@
<glossdef>
<para>
Specifies the optimization flags passed to the C compiler
when building for the host or the SDK.
when building for the build host or the SDK.
The flags are passed through the
<link linkend='var-BUILD_CFLAGS'><filename>BUILD_CFLAGS</filename></link>
and
@@ -2350,6 +2350,12 @@
Specifies additional options for the image
creation command that has been specified in
<link linkend='var-IMAGE_CMD'><filename>IMAGE_CMD</filename></link>.
When setting this variable, you should
use an override for the associated type.
Here is an example:
<literallayout class='monospaced'>
EXTRA_IMAGECMD_ext3 ?= "-i 4096"
</literallayout>
</para>
</glossdef>
</glossentry>
@@ -3196,9 +3202,10 @@
created under <filename>/dev</filename> within the image.
If <filename>IMAGE_DEVICE_TABLES</filename> is not set,
<filename>files/device_table-minimal.txt</filename> is
used.
used, which is located by
<link linkend='var-BBPATH'><filename>BBPATH</filename></link>.
For details on how you should write device table files,
see the <filename>files/device_table-minimal.txt</filename>
see <filename>files/device_table-minimal.txt</filename>
as an example.
</para>
</glossdef>
@@ -3533,7 +3540,7 @@
If the size of the image is not a multiple of
this value, then the size is rounded up to the nearest
multiple of the value.
The default value is 1 Kbyte.
The default value is "1".
See
<link linkend='var-IMAGE_ROOTFS_SIZE'><filename>IMAGE_ROOTFS_SIZE</filename></link>
for additional information.
@@ -5478,10 +5485,10 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
<para>
Specifies a list of architectures compatible with
the target machine.
Separate the entries using spaces and list them in order
of priority.
This variable is set automatically and should not
normally be hand-edited.
Entries are separated using spaces and listed in order
of priority.
The default value for
<filename>PACKAGE_ARCHS</filename> is "all any noarch
${PACKAGE_EXTRA_ARCHS} ${MACHINE_ARCH}".
@@ -7096,10 +7103,10 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
<para>
Specifies a list of architectures compatible with
the SDK machine.
Separate the entries using spaces and list them in order
of priority.
This variable is set automatically and should not
normally be hand-edited.
Entries are separated using spaces and listed in order
of priority.
The default value for
<filename>SDK_PACKAGE_ARCHS</filename> is "all any noarch
${SDK_ARCH}-${SDKPKGSUFFIX}".
@@ -7132,6 +7139,20 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
<filename>.conf</filename> file under
<filename>conf/machine-sdk/</filename>.
</para>
<para>
You can use "i686" and "x86_64" as possible values
for this variable. The variable defaults to "i686"
and is set in the local.conf file in the Build Directory.
<literallayout class='monospaced'>
SDKMACHINE ?= "i686"
</literallayout>
<note>
You cannot set the <filename>SDKMACHINE</filename>
variable in your distribution configuration file.
If you do, the configuration will not take affect.
</note>
</para>
</glossdef>
</glossentry>
@@ -7161,7 +7182,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
<para>
Specifies the optimization flags passed to the C compiler
when building for the target.
The flags are passed through the default
The flags are passed through the default value of the
<link linkend='var-TARGET_CFLAGS'><filename>TARGET_CFLAGS</filename></link>
variable.
</para>
@@ -7635,8 +7656,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
If set to "1", allows fetches from
mirrors that are specified in
<link linkend='var-SSTATE_MIRRORS'><filename>SSTATE_MIRRORS</filename></link>
to work even when <filename>BB_NO_NETWORK</filename>
is set to "1", which disables fetching from the network.
to work even when fetching from the network has been
disabled by setting <filename>BB_NO_NETWORK</filename>
to "1".
Using the
<filename>SSTATE_MIRROR_ALLOW_NETWORK</filename>
variable is useful if you have set