diff --git a/documentation/poky-ref-manual/ref-classes.xml b/documentation/poky-ref-manual/ref-classes.xml
index 5ba9811853..2caea272a4 100644
--- a/documentation/poky-ref-manual/ref-classes.xml
+++ b/documentation/poky-ref-manual/ref-classes.xml
@@ -570,7 +570,7 @@
By default, the B directory is set to the following, which is separate from the
Source Directory (S):
- ${WORKDIR}/${BPN}-{PV}/
+ ${WORKDIR}/${BPN}/{PV}/
See the glossary entries for the
WORKDIR,
diff --git a/documentation/poky-ref-manual/ref-structure.xml b/documentation/poky-ref-manual/ref-structure.xml
index 0b8e7711c2..ea48299600 100644
--- a/documentation/poky-ref-manual/ref-structure.xml
+++ b/documentation/poky-ref-manual/ref-structure.xml
@@ -458,12 +458,15 @@
build/tmp/work/
- This directory contains architecture-specific work sub-directories for packages built by BitBake.
- All tasks execute from a work directory.
- For example, the source for a particular package is unpacked, patched, configured and compiled all
- within its own work directory.
- Within the work directory, organization is based on the package group for which the source
- is being compiled.
+ This directory contains architecture-specific work sub-directories
+ for packages built by BitBake.
+ All tasks execute from the appropriate work directory.
+ For example, the source for a particular package is unpacked,
+ patched, configured and compiled all within its own work directory.
+ Within the work directory, organization is based on the package group
+ and version for which the source is being compiled
+ as defined by the
+ WORKDIR.
@@ -472,8 +475,9 @@
on the machine qemux86
built within the Yocto Project.
For this package, a work directory of
- tmp/work/qemux86-poky-linux/linux-yocto-3.0+git1+<.....>,
- referred to as WORKDIR, is created.
+ tmp/work/qemux86-poky-linux/linux-yocto/3.0+git1+<.....>,
+ referred to as the
+ WORKDIR, is created.
Within this directory, the source is unpacked to
linux-qemux86-standard-build and then patched by Quilt
(see the
@@ -486,13 +490,14 @@
- There are other directories generated within WORKDIR.
- The most important directory is WORKDIR/temp/, which has log files for each
- task (log.do_*.pid) and contains the scripts BitBake runs for
- each task (run.do_*.pid).
- The WORKDIR/image/ directory is where "make
+ There are other directories generated within WORKDIR.
+ The most important directory is WORKDIR/temp/,
+ which has log files for each task (log.do_*.pid)
+ and contains the scripts BitBake runs for each task
+ (run.do_*.pid).
+ The WORKDIR/image/ directory is where "make
install" places its output that is then split into sub-packages
- within WORKDIR/packages-split/.
+ within WORKDIR/packages-split/.
diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index 2765c2f1c9..c490fc360d 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -99,7 +99,7 @@
By default, this directory is the same as the S
directory:
- B = ${WORKDIR}/${BPN}-{PV}/
+ B = ${WORKDIR}/${BPN}/{PV}/
You can separate the (S) directory and the directory pointed to
by the B variable.
@@ -2450,7 +2450,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
package version (PV) as
follows:
- ${WORKDIR}/${PN}-${PV}
+ ${WORKDIR}/${PN}/${PV}
As an example, assume a
Source Directory top-level
@@ -2460,7 +2460,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
In this case, the working directory the build system uses to build
the db package is the following:
- ~/poky/build/tmp/work/qemux86-poky-linux/db-5.1.19-r3/db-5.1.19
+ ~/poky/build/tmp/work/qemux86-poky-linux/db/5.1.19-r3/db-5.1.19
@@ -2967,7 +2967,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
For packages that are not dependent on a particular machine,
WORKDIR is defined as follows:
- ${TMPDIR}/work/${PACKAGE_ARCH}-poky-${TARGET_OS}/${PN}-${PV}-${PR}
+ ${TMPDIR}/work/${PACKAGE_ARCH}-poky-${TARGET_OS}/${PN}/${PV}-${PR}
As an example, assume a
Source Directory top-level
@@ -2977,7 +2977,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
In this case, the working directory the build system uses to build
the v86d package is the following:
- ~/poky/build/tmp/work/qemux86-poky-linux/v86d-01.9-r0
+ ~/poky/build/tmp/work/qemux86-poky-linux/v86d/01.9-r0
@@ -2985,7 +2985,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
For packages that are dependent on a particular machine, WORKDIR
is defined slightly different:
- ${TMPDIR}/work/${MACHINE}-poky-${TARGET_OS}/${PN}-${PV}-${PR}
+ ${TMPDIR}/work/${MACHINE}-poky-${TARGET_OS}/${PN}/${PV}-${PR}
As an example, again assume a Source Directory top-level folder
named poky and a default Build Directory
@@ -2994,7 +2994,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
the acl recipe, which is being built for a
MIPS-based device, is the following:
- ~/poky/build/tmp/work/mips-poky-linux/acl-2.2.51-r2
+ ~/poky/build/tmp/work/mips-poky-linux/acl/2.2.51-r2
diff --git a/documentation/poky-ref-manual/technical-details.xml b/documentation/poky-ref-manual/technical-details.xml
index 72689a0e22..b1d7c40799 100644
--- a/documentation/poky-ref-manual/technical-details.xml
+++ b/documentation/poky-ref-manual/technical-details.xml
@@ -236,7 +236,7 @@
To complicate the problem, there are things that should not be included in
the checksum.
First, there is the actual specific build path of a given task -
- the WORKDIR.
+ the WORKDIR.
It does not matter if the working directory changes because it should not
affect the output for target packages.
Also, the build process has the objective of making native/cross packages relocatable.
@@ -391,7 +391,7 @@
There are two types of output, one is just about creating a directory
- in WORKDIR.
+ in WORKDIR.
A good example is the output of either do_install or
do_package.
The other type of output occurs when a set of data is merged into a shared directory
diff --git a/documentation/poky-ref-manual/usingpoky.xml b/documentation/poky-ref-manual/usingpoky.xml
index 286b5fa783..149490969a 100644
--- a/documentation/poky-ref-manual/usingpoky.xml
+++ b/documentation/poky-ref-manual/usingpoky.xml
@@ -123,7 +123,7 @@
${WORKDIR}/temp/log.do_taskname.pid.
For example, the compile task for the QEMU minimal image for the x86
machine (qemux86) might be
- tmp/work/qemux86-poky-linux/core-image-minimal-1.0-r0/temp/log.do_compile.20830.
+ tmp/work/qemux86-poky-linux/core-image-minimal/1.0-r0/temp/log.do_compile.20830.
To see what BitBake runs to generate that log, look at the corresponding
run.do_taskname.pid file located in the same directory.