documentation: Run-through changes for 1.2

Reading through the manual I discovered some inconsistencies with
how links were handled.  I fixed this in both the QS and one anchor
in the FAQ appendix of the YP Reference Manual.

(From yocto-docs rev: 32444e839a1541ab2c02fa31cd094605d1a2429a)

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 2012-04-10 15:46:02 -06:00 committed by Richard Purdie
parent 17c4134ebd
commit 853c5613ac
2 changed files with 17 additions and 22 deletions

View File

@ -493,7 +493,7 @@
<qandaentry> <qandaentry>
<question> <question>
<para id='how-does-the-yocto-project-obtain-source-code-and-will-it-work-behind-my-firewall-or-proxy-server'> <para id='how-does-the-yocto-project-obtain-source-code-and-will-it-work-behind-my-firewall-or-proxy-server'>
How does the Yocto Project obtain source code and will it work behind my How does the Yocto Project build system obtain source code and will it work behind my
firewall or proxy server? firewall or proxy server?
</para> </para>
</question> </question>

View File

@ -294,9 +294,7 @@
Doing so allows you to contribute back to the project. Doing so allows you to contribute back to the project.
For information on how to get set up using this method, see the For information on how to get set up using this method, see the
"<ulink url='&YOCTO_DOCS_DEV_URL;#local-yp-release'>Yocto "<ulink url='&YOCTO_DOCS_DEV_URL;#local-yp-release'>Yocto
Project Release</ulink>" item in Project Release</ulink>" item in The Yocto Project Development Manual.
<ulink url='&YOCTO_DOCS_DEV_URL;'>The Yocto Project
Development Manual</ulink>.
</para> </para>
</section> </section>
</section> </section>
@ -351,9 +349,9 @@
By default, the Yocto Project searches for source code using a pre-determined order By default, the Yocto Project searches for source code using a pre-determined order
through a set of locations. through a set of locations.
If you encounter problems with the Yocto Project finding and downloading source code, see If you encounter problems with the Yocto Project finding and downloading source code, see
the FAQ entry "How does Poky obtain source code and will it work behind my the FAQ entry "How does the Yocto Project build system obtain source code and will it work behind my
firewall or proxy server?" in firewall or proxy server?" in
<ulink url='&YOCTO_DOCS_REF_URL;'> <ulink url='&YOCTO_DOCS_REF_URL;#faq'>
The Yocto Project Reference Manual</ulink>. The Yocto Project Reference Manual</ulink>.
</para></note> </para></note>
@ -361,14 +359,14 @@
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ wget &YOCTO_POKY_DL_URL; $ wget &YOCTO_POKY_DL_URL;
$ tar xjf &YOCTO_POKY;.tar.bz2 $ tar xjf &YOCTO_POKY;.tar.bz2
$ source &OE_INIT_PATH; edison-6.0-build $ source &OE_INIT_PATH; &YOCTO_POKY;-build
</literallayout> </literallayout>
</para> </para>
<tip><para> <tip><para>
To help conserve disk space during builds, you can add the following statement To help conserve disk space during builds, you can add the following statement
to your project's configuration file, which for this example to your project's configuration file, which for this example
is <filename>edison-6.0-build/conf/local.conf</filename>. is <filename>&YOCTO_POKY;-build/conf/local.conf</filename>.
Adding this statement deletes the work directory used for building a package Adding this statement deletes the work directory used for building a package
once the package is built. once the package is built.
<literallayout class='monospaced'> <literallayout class='monospaced'>
@ -384,13 +382,13 @@
<ulink url='&YOCTO_HOME_URL;/download'>Yocto Project website</ulink> <ulink url='&YOCTO_HOME_URL;/download'>Yocto Project website</ulink>
Downloads page to retrieve the tarball.</para></listitem> Downloads page to retrieve the tarball.</para></listitem>
<listitem><para>The second command extracts the files from the tarball and places <listitem><para>The second command extracts the files from the tarball and places
them into a directory named <filename>poky-edison-6.0</filename> in the current them into a directory named <filename>&YOCTO_POKY;</filename> in the current
directory.</para></listitem> directory.</para></listitem>
<listitem><para>The third command runs the Yocto Project environment setup script. <listitem><para>The third command runs the Yocto Project environment setup script.
Running this script defines Yocto Project build environment settings needed to Running this script defines Yocto Project build environment settings needed to
complete the build. complete the build.
The script also creates the Yocto Project The script also creates the Yocto Project
build directory, which is <filename>edison-6.0-build</filename> in this case. build directory, which is <filename>&YOCTO_POKY;-build</filename> in this case.
After the script runs, your current working directory is set After the script runs, your current working directory is set
to the build directory. to the build directory.
Later, when the build completes, the build directory contains all the files Later, when the build completes, the build directory contains all the files
@ -430,9 +428,8 @@
You can control this configuration by using the You can control this configuration by using the
<filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGE_CLASSES'><filename>PACKAGE_CLASSES</filename></ulink></filename> variable. <filename><ulink url='&YOCTO_DOCS_REF_URL;#var-PACKAGE_CLASSES'><filename>PACKAGE_CLASSES</filename></ulink></filename> variable.
For additional package manager selection information, see For additional package manager selection information, see
"<ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-package'>Packaging - <filename>package*.bbclass</filename></ulink>" in "<ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-package'>Packaging - <filename>package*.bbclass</filename></ulink>"
<ulink url='&YOCTO_DOCS_REF_URL;'> in The Yocto Project Reference Manual.
The Yocto Project Reference Manual</ulink>.
</para> </para>
<para> <para>
@ -441,15 +438,15 @@
For information on the <filename>-k</filename> option use the For information on the <filename>-k</filename> option use the
<filename>bitbake --help</filename> command or see the <filename>bitbake --help</filename> command or see the
"<ulink url='&YOCTO_DOCS_REF_URL;#usingpoky-components-bitbake'>BitBake</ulink>" section in "<ulink url='&YOCTO_DOCS_REF_URL;#usingpoky-components-bitbake'>BitBake</ulink>" section in
<ulink url='&YOCTO_DOCS_REF_URL;'>The Yocto Project Reference Manual</ulink>. The Yocto Project Reference Manual.
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ bitbake -k core-image-sato $ bitbake -k core-image-sato
</literallayout> </literallayout>
<note><para> <note><para>
BitBake requires Python 2.6 or 2.7. For more information on this requirement, BitBake requires Python 2.6 or 2.7. For more information on this requirement,
see the FAQ appendix in see the
<ulink url='&YOCTO_DOCS_REF_URL;'> <ulink url='&YOCTO_DOCS_REF_URL;#faq'>FAQ</ulink> in The Yocto Project Reference
The Yocto Project Reference Manual</ulink>. Manual.
</para></note> </para></note>
The final command runs the image: The final command runs the image:
<literallayout class='monospaced'> <literallayout class='monospaced'>
@ -550,9 +547,8 @@
<para> <para>
For more information on how to install tarballs, see the For more information on how to install tarballs, see the
"<ulink url='&YOCTO_DOCS_ADT_URL;#using-an-existing-toolchain-tarball'>Using a Cross-Toolchain Tarball</ulink>" and "<ulink url='&YOCTO_DOCS_ADT_URL;#using-an-existing-toolchain-tarball'>Using a Cross-Toolchain Tarball</ulink>" and
"<ulink url='&YOCTO_DOCS_ADT_URL;#using-the-toolchain-from-within-the-build-tree'>Using BitBake and the Yocto Project Build Tree</ulink>" sections in "<ulink url='&YOCTO_DOCS_ADT_URL;#using-the-toolchain-from-within-the-build-tree'>Using BitBake and the Yocto Project Build Tree</ulink>" sections in The Yocto Project Application Development Toolkit (ADT)
<ulink url='&YOCTO_DOCS_ADT_URL;'>The Yocto Project User's Guide.
Application Development Toolkit (ADT) User's Guide</ulink>.
</para> </para>
</section> </section>
@ -583,8 +579,7 @@
<para> <para>
You can learn more about downloading a Yocto Project kernel in the You can learn more about downloading a Yocto Project kernel in the
"<ulink url='&YOCTO_DOCS_DEV_URL;#local-kernel-files'>Linux Yocto Kernel</ulink>" section of "<ulink url='&YOCTO_DOCS_DEV_URL;#local-kernel-files'>Linux Yocto Kernel</ulink>" section of
<ulink url='&YOCTO_DOCS_DEV_URL;'>The The Yocto Project Development Manual.
Yocto Project Development Manual</ulink>.
</para> </para>
</section> </section>