diff options
| -rw-r--r-- | documentation/poky-ref-manual/development.xml | 31 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/faq.xml | 22 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/introduction.xml | 21 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/poky-ref-manual.xml | 9 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/ref-bitbake.xml | 10 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/ref-classes.xml | 12 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/ref-features.xml | 3 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/ref-images.xml | 3 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/ref-structure.xml | 14 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/ref-variables.xml | 29 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/ref-varlocality.xml | 3 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/resources.xml | 25 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/technical-details.xml | 18 | ||||
| -rw-r--r-- | documentation/poky-ref-manual/usingpoky.xml | 10 |
14 files changed, 114 insertions, 96 deletions
diff --git a/documentation/poky-ref-manual/development.xml b/documentation/poky-ref-manual/development.xml index c2a9cf7f41..cf396dff3d 100644 --- a/documentation/poky-ref-manual/development.xml +++ b/documentation/poky-ref-manual/development.xml | |||
| @@ -1,5 +1,6 @@ | |||
| 1 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 3 | 4 | ||
| 4 | <chapter id="platdev"> | 5 | <chapter id="platdev"> |
| 5 | <title>Platform Development with the Yocto Project</title> | 6 | <title>Platform Development with the Yocto Project</title> |
| @@ -82,7 +83,7 @@ | |||
| 82 | The current release of the Yocto Project no longer supports the Anjuta plug-in. | 83 | The current release of the Yocto Project no longer supports the Anjuta plug-in. |
| 83 | However, the Poky Anjuta Plug-in is available to download directly from the Poky | 84 | However, the Poky Anjuta Plug-in is available to download directly from the Poky |
| 84 | Git repository located through the web interface at | 85 | Git repository located through the web interface at |
| 85 | <ulink url="http://git.yoctoproject.org/"></ulink> under IDE Plugins. | 86 | <ulink url='&YOCTO_GIT_URL;'></ulink> under IDE Plugins. |
| 86 | The community is free to continue supporting it beyond the Yocto Project 0.9 | 87 | The community is free to continue supporting it beyond the Yocto Project 0.9 |
| 87 | Release. | 88 | Release. |
| 88 | </note> | 89 | </note> |
| @@ -91,8 +92,8 @@ | |||
| 91 | with other plug-ins installed into the Eclipse IDE. | 92 | with other plug-ins installed into the Eclipse IDE. |
| 92 | Once you have your environment setup you need to configure the Eclipse plug-in. | 93 | Once you have your environment setup you need to configure the Eclipse plug-in. |
| 93 | For information on how to install and configure the Eclipse plug-in, see the | 94 | For information on how to install and configure the Eclipse plug-in, see the |
| 94 | "<ulink url='http://www.yoctoproject.org/docs/latest/adt-manual/adt-manual.html#adt-eclipse'>Working Within Eclipse</ulink>" | 95 | "<ulink url='&YOCTO_DOCS_ADT_URL;#adt-eclipse'>Working Within Eclipse</ulink>" |
| 95 | chapter in The Yocto Project Application Development Toolkit (ADT) User's Guide. | 96 | chapter in the Yocto Project Application Development Toolkit (ADT) User's Guide. |
| 96 | </para> | 97 | </para> |
| 97 | </section> | 98 | </section> |
| 98 | 99 | ||
| @@ -100,8 +101,8 @@ | |||
| 100 | <title>External Development Using the QEMU Emulator</title> | 101 | <title>External Development Using the QEMU Emulator</title> |
| 101 | <para> | 102 | <para> |
| 102 | Running Poky QEMU images is covered in the | 103 | Running Poky QEMU images is covered in the |
| 103 | "<ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#test-run'>A Quick Test Run</ulink>" | 104 | "<ulink url='&YOCTO_DOCS_QS_URL;#test-run'>A Quick Test Run</ulink>" |
| 104 | section of The Yocto Project Quick Start. | 105 | section of the Yocto Project Quick Start. |
| 105 | </para> | 106 | </para> |
| 106 | <para> | 107 | <para> |
| 107 | The QEMU images shipped with the Yocto Project contain complete toolchains | 108 | The QEMU images shipped with the Yocto Project contain complete toolchains |
| @@ -160,8 +161,8 @@ | |||
| 160 | <para> | 161 | <para> |
| 161 | Working directly with the Yocto Project is a fast and effective development technique. | 162 | Working directly with the Yocto Project is a fast and effective development technique. |
| 162 | The idea is that you can directly edit files in a working directory | 163 | The idea is that you can directly edit files in a working directory |
| 163 | (<glossterm><link linkend='var-WORKDIR'>WORKDIR</link></glossterm>) | 164 | (<filename><link linkend='var-WORKDIR'>WORKDIR</link></filename>) |
| 164 | or the source directory (<glossterm><link linkend='var-S'>S</link></glossterm>) | 165 | or the source directory (<filename><link linkend='var-S'>S</link></filename>) |
| 165 | and then force specific tasks to rerun in order to test the changes. | 166 | and then force specific tasks to rerun in order to test the changes. |
| 166 | An example session working on the matchbox-desktop package might | 167 | An example session working on the matchbox-desktop package might |
| 167 | look like this: | 168 | look like this: |
| @@ -201,9 +202,9 @@ | |||
| 201 | <para> | 202 | <para> |
| 202 | It is useful when making changes directly to the work directory files to do | 203 | It is useful when making changes directly to the work directory files to do |
| 203 | so using the Quilt tool as detailed in the | 204 | so using the Quilt tool as detailed in the |
| 204 | "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#using-a-quilt-workflow'>Using a Quilt Workflow</ulink>" section in the Yocto Project Development Manual. | 205 | "<ulink url='&YOCTO_DOCS_DEV_URL;#using-a-quilt-workflow'>Using a Quilt Workflow</ulink>" section in the Yocto Project Development Manual. |
| 205 | Using Quilt, you can copy patches into the recipe directory and use the patches directly | 206 | Using Quilt, you can copy patches into the recipe directory and use the patches directly |
| 206 | through use of the <glossterm><link linkend='var-SRC_URI'>SRC_URI</link></glossterm> variable. | 207 | through use of the <filename><link linkend='var-SRC_URI'>SRC_URI</link></filename> variable. |
| 207 | </para> | 208 | </para> |
| 208 | 209 | ||
| 209 | <para> | 210 | <para> |
| @@ -258,7 +259,7 @@ | |||
| 258 | or <filename>compile</filename> commands as if they were being run by | 259 | or <filename>compile</filename> commands as if they were being run by |
| 259 | the Yocto Project build system itself. | 260 | the Yocto Project build system itself. |
| 260 | As noted earlier, the working directory also automatically changes to the | 261 | As noted earlier, the working directory also automatically changes to the |
| 261 | source directory (<glossterm><link linkend='var-S'>S</link></glossterm>). | 262 | source directory (<filename><link linkend='var-S'>S</link></filename>). |
| 262 | </para> | 263 | </para> |
| 263 | 264 | ||
| 264 | <para> | 265 | <para> |
| @@ -268,8 +269,8 @@ | |||
| 268 | <para> | 269 | <para> |
| 269 | The default shell used by <filename>devshell</filename> is xterm. | 270 | The default shell used by <filename>devshell</filename> is xterm. |
| 270 | You can use other terminal forms by setting the | 271 | You can use other terminal forms by setting the |
| 271 | <glossterm><link linkend='var-TERMCMD'>TERMCMD</link></glossterm> and | 272 | <filename><link linkend='var-TERMCMD'>TERMCMD</link></filename> and |
| 272 | <glossterm><link linkend='var-TERMCMDRUN'>TERMCMDRUN</link></glossterm> variables | 273 | <filename><link linkend='var-TERMCMDRUN'>TERMCMDRUN</link></filename> variables |
| 273 | in the Yocto Project's <filename>local.conf</filename> file found in the build | 274 | in the Yocto Project's <filename>local.conf</filename> file found in the build |
| 274 | directory. | 275 | directory. |
| 275 | For examples of the other options available, see the "UI/Interaction Configuration" | 276 | For examples of the other options available, see the "UI/Interaction Configuration" |
| @@ -667,7 +668,7 @@ | |||
| 667 | <para> | 668 | <para> |
| 668 | A graphical user interface for OProfile is also available. | 669 | A graphical user interface for OProfile is also available. |
| 669 | You can download and build this interface from the Yocto Project at | 670 | You can download and build this interface from the Yocto Project at |
| 670 | <ulink url="http://git.yoctoproject.org/cgit.cgi/oprofileui/"></ulink>. | 671 | <ulink url="&YOCTO_GIT_URL;/cgit.cgi/oprofileui/"></ulink>. |
| 671 | If the "tools-profile" image feature is selected, all necessary binaries | 672 | If the "tools-profile" image feature is selected, all necessary binaries |
| 672 | are installed onto the target device for OProfileUI interaction. | 673 | are installed onto the target device for OProfileUI interaction. |
| 673 | </para> | 674 | </para> |
| @@ -675,7 +676,7 @@ | |||
| 675 | <para> | 676 | <para> |
| 676 | Even though the Yocto Project usually includes all needed patches on the target device, you | 677 | Even though the Yocto Project usually includes all needed patches on the target device, you |
| 677 | might find you need other OProfile patches for recent OProfileUI features. | 678 | might find you need other OProfile patches for recent OProfileUI features. |
| 678 | If so, see the <ulink url='http://git.yoctoproject.org/cgit.cgi/oprofileui/tree/README'> | 679 | If so, see the <ulink url='&YOCTO_GIT_URL;/cgit.cgi/oprofileui/tree/README'> |
| 679 | OProfileUI README</ulink> for the most recent information. | 680 | OProfileUI README</ulink> for the most recent information. |
| 680 | </para> | 681 | </para> |
| 681 | 682 | ||
diff --git a/documentation/poky-ref-manual/faq.xml b/documentation/poky-ref-manual/faq.xml index 4cf52443c1..0a64147523 100644 --- a/documentation/poky-ref-manual/faq.xml +++ b/documentation/poky-ref-manual/faq.xml | |||
| @@ -1,5 +1,6 @@ | |||
| 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 3 | 4 | ||
| 4 | <appendix id='faq'> | 5 | <appendix id='faq'> |
| 5 | <title>FAQ</title> | 6 | <title>FAQ</title> |
| @@ -7,13 +8,13 @@ | |||
| 7 | <qandaentry> | 8 | <qandaentry> |
| 8 | <question> | 9 | <question> |
| 9 | <para> | 10 | <para> |
| 10 | How does Poky differ from <ulink url='http://www.openembedded.org/'>OpenEmbedded</ulink>? | 11 | How does Poky differ from <ulink url='&OE_HOME_URL;'>OpenEmbedded</ulink>? |
| 11 | </para> | 12 | </para> |
| 12 | </question> | 13 | </question> |
| 13 | <answer> | 14 | <answer> |
| 14 | <para> | 15 | <para> |
| 15 | Poky is the Yocto Project build system that was derived from <ulink | 16 | Poky is the Yocto Project build system that was derived from <ulink |
| 16 | url='http://www.openembedded.org/'>OpenEmbedded</ulink>. | 17 | url='&OE_HOME_URL;'>OpenEmbedded</ulink>. |
| 17 | Poky is a stable, smaller subset focused on the mobile environment. | 18 | Poky is a stable, smaller subset focused on the mobile environment. |
| 18 | Development in the Yocto Project using Poky is closely tied to OpenEmbedded with | 19 | Development in the Yocto Project using Poky is closely tied to OpenEmbedded with |
| 19 | features being merged regularly between the two for mutual benefit. | 20 | features being merged regularly between the two for mutual benefit. |
| @@ -33,8 +34,8 @@ | |||
| 33 | You can use a stand-alone tarball to provide Python 2.6. | 34 | You can use a stand-alone tarball to provide Python 2.6. |
| 34 | You can find pre-built 32 and 64-bit versions of Python 2.6 at the following locations: | 35 | You can find pre-built 32 and 64-bit versions of Python 2.6 at the following locations: |
| 35 | <itemizedlist> | 36 | <itemizedlist> |
| 36 | <listitem><para><ulink url='http://downloads.yoctoproject.org/releases/miscsupport/yocto-1.0-python-nativesdk/python-nativesdk-standalone-i686.tar.bz2'>32-bit tarball</ulink></para></listitem> | 37 | <listitem><para><ulink url='&YOCTO_PYTHON-i686_DL_URL;'>32-bit tarball</ulink></para></listitem> |
| 37 | <listitem><para><ulink url='http://downloads.yoctoproject.org/releases/miscsupport/yocto-1.0-python-nativesdk/python-nativesdk-standalone-x86_64.tar.bz2'>64-bit tarball</ulink></para></listitem> | 38 | <listitem><para><ulink url='&YOCTO_PYTHON-x86_64_DL_URL;'>64-bit tarball</ulink></para></listitem> |
| 38 | </itemizedlist> | 39 | </itemizedlist> |
| 39 | </para> | 40 | </para> |
| 40 | <para> | 41 | <para> |
| @@ -139,7 +140,8 @@ | |||
| 139 | <para> | 140 | <para> |
| 140 | To add a package, you need to create a BitBake recipe. | 141 | To add a package, you need to create a BitBake recipe. |
| 141 | For information on how to add a package, see the section | 142 | For information on how to add a package, see the section |
| 142 | "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#usingpoky-extend-addpkg'>Adding a Package</ulink>" in the Yocto Project Development Manual. | 143 | "<ulink url='&YOCTO_DOCS_DEV_URL;#usingpoky-extend-addpkg'>Adding a Package</ulink>" |
| 144 | in the Yocto Project Development Manual. | ||
| 143 | </para> | 145 | </para> |
| 144 | </answer> | 146 | </answer> |
| 145 | </qandaentry> | 147 | </qandaentry> |
| @@ -170,7 +172,7 @@ | |||
| 170 | </question> | 172 | </question> |
| 171 | <answer> | 173 | <answer> |
| 172 | <para> | 174 | <para> |
| 173 | <ulink url='http://www.gnome.org/mobile/'>GNOME Mobile</ulink> is a subset of the GNOME | 175 | GNOME Mobile is a subset of the <ulink url='http://www.gnome.org'>GNOME</ulink> |
| 174 | platform targeted at mobile and embedded devices. | 176 | platform targeted at mobile and embedded devices. |
| 175 | The the main difference between GNOME Mobile and standard GNOME is that | 177 | The the main difference between GNOME Mobile and standard GNOME is that |
| 176 | desktop-orientated libraries have been removed, along with deprecated libraries, | 178 | desktop-orientated libraries have been removed, along with deprecated libraries, |
| @@ -216,7 +218,7 @@ | |||
| 216 | <ulink url='http://dag.wieers.com/rpm/packages/python-sqlite2/'>DAG repository</ulink> | 218 | <ulink url='http://dag.wieers.com/rpm/packages/python-sqlite2/'>DAG repository</ulink> |
| 217 | </para></listitem> | 219 | </para></listitem> |
| 218 | <listitem><para><filename>help2man</filename> from | 220 | <listitem><para><filename>help2man</filename> from |
| 219 | <ulink url='http://centos.karan.org/el5/extras/testing/i386/RPMS/help2man-1.33.1-2.noarch.rpm'>Karan repository</ulink></para></listitem> | 221 | <ulink url='http://centos.karan.org/el4/extras/stable/x86_64/RPMS/repodata/repoview/help2man-0-1.33.1-2.html'>Karan repository</ulink></para></listitem> |
| 220 | </itemizedlist> | 222 | </itemizedlist> |
| 221 | </para> | 223 | </para> |
| 222 | 224 | ||
| @@ -269,9 +271,7 @@ | |||
| 269 | </filename> = "0" in the <filename>.bb</filename> file but make sure the package is | 271 | </filename> = "0" in the <filename>.bb</filename> file but make sure the package is |
| 270 | manually marked as | 272 | manually marked as |
| 271 | machine-specific in the case that needs it. | 273 | machine-specific in the case that needs it. |
| 272 | The code that handles | 274 | The code that handles <filename>SRC_URI_OVERRIDES_PACKAGE_ARCH</filename> is in <filename>base.bbclass</filename>. |
| 273 | <filename><link linkend='var-SRC_URI_OVERRIDES_PACKAGE_ARCH'> | ||
| 274 | SRC_URI_OVERRIDES_PACKAGE_ARCH</link></filename> is in <filename>base.bbclass</filename>. | ||
| 275 | </para> | 275 | </para> |
| 276 | </answer> | 276 | </answer> |
| 277 | </qandaentry> | 277 | </qandaentry> |
diff --git a/documentation/poky-ref-manual/introduction.xml b/documentation/poky-ref-manual/introduction.xml index fd98c3248b..160cdca73d 100644 --- a/documentation/poky-ref-manual/introduction.xml +++ b/documentation/poky-ref-manual/introduction.xml | |||
| @@ -1,5 +1,6 @@ | |||
| 1 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 3 | 4 | ||
| 4 | <chapter id='intro'> | 5 | <chapter id='intro'> |
| 5 | <title>Introduction</title> | 6 | <title>Introduction</title> |
| @@ -15,13 +16,13 @@ | |||
| 15 | construct complete Linux images. | 16 | construct complete Linux images. |
| 16 | You can find complete introductory and getting started information on the Yocto Project | 17 | You can find complete introductory and getting started information on the Yocto Project |
| 17 | by reading the | 18 | by reading the |
| 18 | <ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html'> | 19 | <ulink url='&YOCTO_DOCS_QS_URL;'> |
| 19 | Yocto Project Quick Start</ulink>. | 20 | Yocto Project Quick Start</ulink>. |
| 20 | For task-based information using the Yocto Project, see | 21 | For task-based information using the Yocto Project, see |
| 21 | <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html'> | 22 | <ulink url='&YOCTO_DOCS_DEV_URL;'> |
| 22 | The Yocto Project Development Manual</ulink>. | 23 | The Yocto Project Development Manual</ulink>. |
| 23 | You can also find lots of information on the Yocto Project on the | 24 | You can also find lots of information on the Yocto Project on the |
| 24 | <ulink url="http://www.yoctoproject.org">Yocto Project website</ulink>. | 25 | <ulink url="&YOCTO_HOME_URL;">Yocto Project website</ulink>. |
| 25 | </para> | 26 | </para> |
| 26 | </section> | 27 | </section> |
| 27 | 28 | ||
| @@ -94,10 +95,8 @@ | |||
| 94 | <title>System Requirements</title> | 95 | <title>System Requirements</title> |
| 95 | <para> | 96 | <para> |
| 96 | For Yocto Project system requirements, see the | 97 | For Yocto Project system requirements, see the |
| 97 | <ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#resources'> | 98 | <ulink url='&YOCTO_DOCS_QS_URL;#resources'> |
| 98 | What You Need and How You Get It</ulink> section in the | 99 | What You Need and How You Get It</ulink> section in the Yocto Project Quick Start. |
| 99 | <ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html'> | ||
| 100 | Yocto Project Quick Start</ulink>. | ||
| 101 | </para> | 100 | </para> |
| 102 | </section> | 101 | </section> |
| 103 | 102 | ||
| @@ -108,14 +107,14 @@ | |||
| 108 | of methods: | 107 | of methods: |
| 109 | <itemizedlist> | 108 | <itemizedlist> |
| 110 | <listitem><para><emphasis>Releases:</emphasis> Stable, tested releases are available through | 109 | <listitem><para><emphasis>Releases:</emphasis> Stable, tested releases are available through |
| 111 | <ulink url='http://downloads.yoctoproject.org/releases/yocto/'/>.</para></listitem> | 110 | <ulink url='&YOCTO_DL_URL;/releases/yocto/'/>.</para></listitem> |
| 112 | <listitem><para><emphasis>Nightly Builds:</emphasis> These releases are available at | 111 | <listitem><para><emphasis>Nightly Builds:</emphasis> These releases are available at |
| 113 | <ulink url='http://autobuilder.yoctoproject.org/nightly'/>. | 112 | <ulink url='http://autobuilder.yoctoproject.org/nightly'/>. |
| 114 | These builds include Yocto Project releases, meta-toolchain tarballs, and | 113 | These builds include Yocto Project releases, meta-toolchain tarballs, and |
| 115 | experimental builds.</para></listitem> | 114 | experimental builds.</para></listitem> |
| 116 | <listitem><para><emphasis>Yocto Project Website:</emphasis> You can find releases | 115 | <listitem><para><emphasis>Yocto Project Website:</emphasis> You can find releases |
| 117 | of the Yocto Project and supported BSPs at the | 116 | of the Yocto Project and supported BSPs at the |
| 118 | <ulink url='http://www.yoctoproject.org'>Yocto Project website</ulink>. | 117 | <ulink url='&YOCTO_HOME_URL;'>Yocto Project website</ulink>. |
| 119 | Along with these downloads, you can find lots of other information at this site. | 118 | Along with these downloads, you can find lots of other information at this site. |
| 120 | </para></listitem> | 119 | </para></listitem> |
| 121 | </itemizedlist> | 120 | </itemizedlist> |
| @@ -129,7 +128,7 @@ | |||
| 129 | You can get these files by downloading a Yocto Project release tarball and unpacking it, | 128 | You can get these files by downloading a Yocto Project release tarball and unpacking it, |
| 130 | or by establishing a Git repository of the files. | 129 | or by establishing a Git repository of the files. |
| 131 | For information on both these methods, see the | 130 | For information on both these methods, see the |
| 132 | "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#getting-setup'>Getting Setup</ulink>" | 131 | "<ulink url='&YOCTO_DOCS_DEV_URL;#getting-setup'>Getting Setup</ulink>" |
| 133 | section in The Yocto Project Development Manual. | 132 | section in The Yocto Project Development Manual. |
| 134 | </para> | 133 | </para> |
| 135 | </section> | 134 | </section> |
diff --git a/documentation/poky-ref-manual/poky-ref-manual.xml b/documentation/poky-ref-manual/poky-ref-manual.xml index b07f213c13..2039fba063 100644 --- a/documentation/poky-ref-manual/poky-ref-manual.xml +++ b/documentation/poky-ref-manual/poky-ref-manual.xml | |||
| @@ -1,5 +1,6 @@ | |||
| 1 | <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 3 | 4 | ||
| 4 | <book id='poky-ref-manual' lang='en' | 5 | <book id='poky-ref-manual' lang='en' |
| 5 | xmlns:xi="http://www.w3.org/2003/XInclude" | 6 | xmlns:xi="http://www.w3.org/2003/XInclude" |
| @@ -65,7 +66,7 @@ | |||
| 65 | </revhistory> | 66 | </revhistory> |
| 66 | 67 | ||
| 67 | <copyright> | 68 | <copyright> |
| 68 | <year>2007-2012</year> | 69 | <year>©RIGHT_YEAR;</year> |
| 69 | <holder>Linux Foundation</holder> | 70 | <holder>Linux Foundation</holder> |
| 70 | </copyright> | 71 | </copyright> |
| 71 | 72 | ||
| @@ -77,9 +78,9 @@ | |||
| 77 | <note> | 78 | <note> |
| 78 | Due to production processes, there could be differences between the Yocto Project | 79 | Due to production processes, there could be differences between the Yocto Project |
| 79 | documentation bundled in the release tarball and | 80 | documentation bundled in the release tarball and |
| 80 | <ulink url='http://www.yoctoproject.org/docs/latest/poky-ref-manual/poky-ref-manual.html'> | 81 | <ulink url='&YOCTO_DOCS_REF_URL;'> |
| 81 | The Yocto Project Reference Manual</ulink> on | 82 | The Yocto Project Reference Manual</ulink> on |
| 82 | the <ulink url='http://www.yoctoproject.org'>Yocto Project</ulink> website. | 83 | the <ulink url='&YOCTO_HOME_URL;'>Yocto Project</ulink> website. |
| 83 | For the latest version of this manual, see the manual on the website. | 84 | For the latest version of this manual, see the manual on the website. |
| 84 | </note> | 85 | </note> |
| 85 | </legalnotice> | 86 | </legalnotice> |
diff --git a/documentation/poky-ref-manual/ref-bitbake.xml b/documentation/poky-ref-manual/ref-bitbake.xml index 146f95d9e4..e8a5dc60ab 100644 --- a/documentation/poky-ref-manual/ref-bitbake.xml +++ b/documentation/poky-ref-manual/ref-bitbake.xml | |||
| @@ -1,5 +1,6 @@ | |||
| 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 3 | 4 | ||
| 4 | <appendix id='ref-bitbake'> | 5 | <appendix id='ref-bitbake'> |
| 5 | 6 | ||
| @@ -86,7 +87,8 @@ | |||
| 86 | <filename>meta/recipes-*/</filename> directory within Poky. | 87 | <filename>meta/recipes-*/</filename> directory within Poky. |
| 87 | Adding extra content to <filename>BBFILES</filename> is best achieved through the use of | 88 | Adding extra content to <filename>BBFILES</filename> is best achieved through the use of |
| 88 | BitBake layers as described in the | 89 | BitBake layers as described in the |
| 89 | "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#understanding-and-creating-layers'>Understanding and Creating Layers</ulink>" section of the Yocto Project Development Manual. | 90 | "<ulink url='&YOCTO_DOCS_DEV_URL;#understanding-and-creating-layers'>Understanding and |
| 91 | Creating Layers</ulink>" section of the Yocto Project Development Manual. | ||
| 90 | </para> | 92 | </para> |
| 91 | 93 | ||
| 92 | <para> | 94 | <para> |
| @@ -207,8 +209,8 @@ | |||
| 207 | It is worth noting that you can greatly speed up the build time by properly setting | 209 | It is worth noting that you can greatly speed up the build time by properly setting |
| 208 | the <filename>BB_NUMBER_THREADS</filename> variable. | 210 | the <filename>BB_NUMBER_THREADS</filename> variable. |
| 209 | See the | 211 | See the |
| 210 | "<ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#building-image'>Building an Image</ulink>" | 212 | "<ulink url='&YOCTO_DOCS_QS_URL;#building-image'>Building an Image</ulink>" |
| 211 | section in The Yocto Project Quick Start for more information. | 213 | section in the Yocto Project Quick Start for more information. |
| 212 | </para> | 214 | </para> |
| 213 | 215 | ||
| 214 | <para> | 216 | <para> |
diff --git a/documentation/poky-ref-manual/ref-classes.xml b/documentation/poky-ref-manual/ref-classes.xml index e2bf9fed99..35c713434c 100644 --- a/documentation/poky-ref-manual/ref-classes.xml +++ b/documentation/poky-ref-manual/ref-classes.xml | |||
| @@ -1,5 +1,6 @@ | |||
| 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 3 | 4 | ||
| 4 | <appendix id='ref-classes'> | 5 | <appendix id='ref-classes'> |
| 5 | <title>Reference: Classes</title> | 6 | <title>Reference: Classes</title> |
| @@ -52,7 +53,8 @@ | |||
| 52 | and then simply <filename>inherit autotools</filename>. | 53 | and then simply <filename>inherit autotools</filename>. |
| 53 | This class can also work with software that emulates Autotools. | 54 | This class can also work with software that emulates Autotools. |
| 54 | For more information, see the | 55 | For more information, see the |
| 55 | "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#usingpoky-extend-addpkg-autotools'>Autotooled Package</ulink>" section in the Yocto Project Development Manual. | 56 | "<ulink url='&YOCTO_DOCS_DEV_URL;#usingpoky-extend-addpkg-autotools'>Autotooled Package</ulink>" |
| 57 | section in the Yocto Project Development Manual. | ||
| 56 | </para> | 58 | </para> |
| 57 | 59 | ||
| 58 | <para> | 60 | <para> |
| @@ -314,9 +316,9 @@ | |||
| 314 | You can find additional information on the effects of the package class at these | 316 | You can find additional information on the effects of the package class at these |
| 315 | two Yocto Project mailing list links: | 317 | two Yocto Project mailing list links: |
| 316 | <itemizedlist> | 318 | <itemizedlist> |
| 317 | <listitem><para><ulink url='https://lists.yoctoproject.org/pipermail/poky/2011-May/006362.html'> | 319 | <listitem><para><ulink url='&YOCTO_LISTS_URL;/pipermail/poky/2011-May/006362.html'> |
| 318 | https://lists.yoctoproject.org/pipermail/poky/2011-May/006362.html</ulink></para></listitem> | 320 | https://lists.yoctoproject.org/pipermail/poky/2011-May/006362.html</ulink></para></listitem> |
| 319 | <listitem><para><ulink url='https://lists.yoctoproject.org/pipermail/poky/2011-May/006363.html'> | 321 | <listitem><para><ulink url='&YOCTO_LISTS_URL;/pipermail/poky/2011-May/006363.html'> |
| 320 | https://lists.yoctoproject.org/pipermail/poky/2011-May/006363.html</ulink></para></listitem> | 322 | https://lists.yoctoproject.org/pipermail/poky/2011-May/006363.html</ulink></para></listitem> |
| 321 | </itemizedlist> | 323 | </itemizedlist> |
| 322 | </para> | 324 | </para> |
| @@ -577,7 +579,7 @@ | |||
| 577 | 579 | ||
| 578 | <para> | 580 | <para> |
| 579 | For information on how to use this class, see the | 581 | For information on how to use this class, see the |
| 580 | "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#building-software-from-an-external-source'>Building | 582 | "<ulink url='&YOCTO_DOCS_DEV_URL;#building-software-from-an-external-source'>Building |
| 581 | Software from an External Source</ulink>" section in the Yocto Project Development Manual. | 583 | Software from an External Source</ulink>" section in the Yocto Project Development Manual. |
| 582 | </para> | 584 | </para> |
| 583 | </section> | 585 | </section> |
diff --git a/documentation/poky-ref-manual/ref-features.xml b/documentation/poky-ref-manual/ref-features.xml index 6b3e5c241e..c61b985f8a 100644 --- a/documentation/poky-ref-manual/ref-features.xml +++ b/documentation/poky-ref-manual/ref-features.xml | |||
| @@ -1,5 +1,6 @@ | |||
| 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 3 | 4 | ||
| 4 | <appendix id='ref-features'> | 5 | <appendix id='ref-features'> |
| 5 | <title>Reference: Features</title> | 6 | <title>Reference: Features</title> |
diff --git a/documentation/poky-ref-manual/ref-images.xml b/documentation/poky-ref-manual/ref-images.xml index 1e0b601a4a..a732e2ab92 100644 --- a/documentation/poky-ref-manual/ref-images.xml +++ b/documentation/poky-ref-manual/ref-images.xml | |||
| @@ -1,5 +1,6 @@ | |||
| 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 3 | 4 | ||
| 4 | <appendix id='ref-images'> | 5 | <appendix id='ref-images'> |
| 5 | <title>Reference: Images</title> | 6 | <title>Reference: Images</title> |
diff --git a/documentation/poky-ref-manual/ref-structure.xml b/documentation/poky-ref-manual/ref-structure.xml index d12604536c..3af4139151 100644 --- a/documentation/poky-ref-manual/ref-structure.xml +++ b/documentation/poky-ref-manual/ref-structure.xml | |||
| @@ -1,5 +1,6 @@ | |||
| 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 3 | 4 | ||
| 4 | <appendix id='ref-structure'> | 5 | <appendix id='ref-structure'> |
| 5 | 6 | ||
| @@ -14,8 +15,8 @@ | |||
| 14 | 15 | ||
| 15 | <para> | 16 | <para> |
| 16 | For information on how to establish the Yocto Project files on your local development system, see the | 17 | For information on how to establish the Yocto Project files on your local development system, see the |
| 17 | "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#getting-started'>Getting Setup</ulink>" | 18 | "<ulink url='&YOCTO_DOCS_DEV_URL;#getting-setup'>Getting Set Up</ulink>" |
| 18 | section in The Yocto Project Development Manual. | 19 | section in the Yocto Project Development Manual. |
| 19 | </para> | 20 | </para> |
| 20 | 21 | ||
| 21 | <section id='structure-core'> | 22 | <section id='structure-core'> |
| @@ -387,7 +388,8 @@ | |||
| 387 | Within this directory, the source is unpacked to | 388 | Within this directory, the source is unpacked to |
| 388 | <filename>linux-qemux86-standard-build</filename> and then patched by Quilt | 389 | <filename>linux-qemux86-standard-build</filename> and then patched by Quilt |
| 389 | (see the | 390 | (see the |
| 390 | "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#usingpoky-modifying-packages-quilt'>Modifying Package Source Code with Quilt</ulink>" section in the Yocto Project Development Manual. | 391 | "<ulink url='&YOCTO_DOCS_DEV_URL;#using-a-quilt-workflow'>Modifying Package |
| 392 | Source Code with Quilt</ulink>" section in the Yocto Project Development Manual. | ||
| 391 | Within the <filename>linux-qemux86-standard-build</filename> directory, | 393 | Within the <filename>linux-qemux86-standard-build</filename> directory, |
| 392 | standard Quilt directories <filename>linux-3.0/patches</filename> | 394 | standard Quilt directories <filename>linux-3.0/patches</filename> |
| 393 | and <filename>linux-3.0/.pc</filename> are created, | 395 | and <filename>linux-3.0/.pc</filename> are created, |
| @@ -478,8 +480,8 @@ | |||
| 478 | <title><filename>meta/recipes-bsp/</filename></title> | 480 | <title><filename>meta/recipes-bsp/</filename></title> |
| 479 | 481 | ||
| 480 | <para> | 482 | <para> |
| 481 | This directory contains anything linking to specific hardware or hardware configuration information | 483 | This directory contains anything linking to specific hardware or hardware |
| 482 | such as "u-boot" and "grub". | 484 | configuration information such as "u-boot" and "grub". |
| 483 | </para> | 485 | </para> |
| 484 | </section> | 486 | </section> |
| 485 | 487 | ||
diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml index 8356cb4a5c..d2b96048b2 100644 --- a/documentation/poky-ref-manual/ref-variables.xml +++ b/documentation/poky-ref-manual/ref-variables.xml | |||
| @@ -1,5 +1,6 @@ | |||
| 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 3 | 4 | ||
| 4 | <!-- Dummy chapter --> | 5 | <!-- Dummy chapter --> |
| 5 | <appendix id='ref-variables-glos'> | 6 | <appendix id='ref-variables-glos'> |
| @@ -421,8 +422,9 @@ | |||
| 421 | <glossdef> | 422 | <glossdef> |
| 422 | <para>Alias names used for the recipe in various Linux distributions.</para> | 423 | <para>Alias names used for the recipe in various Linux distributions.</para> |
| 423 | <para>See the | 424 | <para>See the |
| 424 | "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#usingpoky-configuring-DISTRO_PN_ALIAS'>Handling a Package Name Alias</ulink>" | 425 | "<ulink url='&YOCTO_DOCS_DEV_URL;#usingpoky-configuring-DISTRO_PN_ALIAS'>Handling |
| 425 | section in the Yocto Project Development Manual for more information.</para> | 426 | a Package Name Alias</ulink>" section in the Yocto Project Development |
| 427 | Manual for more information.</para> | ||
| 426 | </glossdef> | 428 | </glossdef> |
| 427 | </glossentry> | 429 | </glossentry> |
| 428 | 430 | ||
| @@ -466,7 +468,8 @@ | |||
| 466 | <para> | 468 | <para> |
| 467 | You can safely share this directory between multiple builds on the | 469 | You can safely share this directory between multiple builds on the |
| 468 | same development machine. | 470 | same development machine. |
| 469 | For additional information on how the build process gets source files, see the | 471 | For additional information on how the build process gets source files |
| 472 | when working behind a firewall or proxy server, see the | ||
| 470 | "<link linkend='how-does-the-yocto-project-obtain-source-code-and-will-it-work-behind-my-firewall-or-proxy-server'>FAQ</link>" | 473 | "<link linkend='how-does-the-yocto-project-obtain-source-code-and-will-it-work-behind-my-firewall-or-proxy-server'>FAQ</link>" |
| 471 | appendix. | 474 | appendix. |
| 472 | </para> | 475 | </para> |
| @@ -663,7 +666,7 @@ | |||
| 663 | The default value for the <filename>FILESPATH</filename> variable is defined | 666 | The default value for the <filename>FILESPATH</filename> variable is defined |
| 664 | in the <filename>base.bbclass</filename> class found in | 667 | in the <filename>base.bbclass</filename> class found in |
| 665 | <filename>meta/classes</filename> in the | 668 | <filename>meta/classes</filename> in the |
| 666 | <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#yocto-project-files'>Yocto Project Files</ulink>: | 669 | <ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-files'>Yocto Project Files</ulink>: |
| 667 | <literallayout class='monospaced'> | 670 | <literallayout class='monospaced'> |
| 668 | FILESPATH = "${@base_set_filespath([ "${FILE_DIRNAME}/${PF}", \ | 671 | FILESPATH = "${@base_set_filespath([ "${FILE_DIRNAME}/${PF}", \ |
| 669 | "${FILE_DIRNAME}/${P}", "${FILE_DIRNAME}/${PN}", \ | 672 | "${FILE_DIRNAME}/${P}", "${FILE_DIRNAME}/${PN}", \ |
| @@ -1085,7 +1088,7 @@ FILESPATH = "${@base_set_filespath([ "${FILE_DIRNAME}/${PF}", \ | |||
| 1085 | is set to "CLOSED")</para> | 1088 | is set to "CLOSED")</para> |
| 1086 | <para>For more information, see the | 1089 | <para>For more information, see the |
| 1087 | <link linkend='usingpoky-configuring-LIC_FILES_CHKSUM'> | 1090 | <link linkend='usingpoky-configuring-LIC_FILES_CHKSUM'> |
| 1088 | Track License Change</link> section</para> | 1091 | Tracking License Changes</link> section</para> |
| 1089 | </glossdef> | 1092 | </glossdef> |
| 1090 | </glossentry> | 1093 | </glossentry> |
| 1091 | 1094 | ||
| @@ -1577,7 +1580,7 @@ FILESPATH = "${@base_set_filespath([ "${FILE_DIRNAME}/${PF}", \ | |||
| 1577 | <glossentry id='var-S'><glossterm>S</glossterm> | 1580 | <glossentry id='var-S'><glossterm>S</glossterm> |
| 1578 | <glossdef> | 1581 | <glossdef> |
| 1579 | <para> | 1582 | <para> |
| 1580 | The location in the <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#yocto-project-build-directory'> | 1583 | The location in the <ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-build-directory'> |
| 1581 | Yocto Project Build Directory</ulink> where unpacked package source code resides. | 1584 | Yocto Project Build Directory</ulink> where unpacked package source code resides. |
| 1582 | This location is within the working directory | 1585 | This location is within the working directory |
| 1583 | (<filename><link linkend='var-WORKDIR'>WORKDIR</link></filename>), which | 1586 | (<filename><link linkend='var-WORKDIR'>WORKDIR</link></filename>), which |
| @@ -1590,7 +1593,7 @@ FILESPATH = "${@base_set_filespath([ "${FILE_DIRNAME}/${PF}", \ | |||
| 1590 | ${WORKDIR}/${PN}-${PV} | 1593 | ${WORKDIR}/${PN}-${PV} |
| 1591 | </literallayout> | 1594 | </literallayout> |
| 1592 | As an example, assume a | 1595 | As an example, assume a |
| 1593 | <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#yocto-project-files'> | 1596 | <ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-files'> |
| 1594 | Yocto Project Files</ulink> top-level directory named <filename>poky</filename> | 1597 | Yocto Project Files</ulink> top-level directory named <filename>poky</filename> |
| 1595 | and a default Yocto Project Build Directory of <filename>poky/build</filename>. | 1598 | and a default Yocto Project Build Directory of <filename>poky/build</filename>. |
| 1596 | In this case, the working directory the build system uses to build | 1599 | In this case, the working directory the build system uses to build |
| @@ -1859,7 +1862,7 @@ FILESPATH = "${@base_set_filespath([ "${FILE_DIRNAME}/${PF}", \ | |||
| 1859 | uses when it does its work building images. | 1862 | uses when it does its work building images. |
| 1860 | By default, the <filename>TMPDIR</filename> variable is named | 1863 | By default, the <filename>TMPDIR</filename> variable is named |
| 1861 | <filename>tmp</filename> within the | 1864 | <filename>tmp</filename> within the |
| 1862 | <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#yocto-project-build-directory'> | 1865 | <ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-build-directory'> |
| 1863 | Yocto Project Build Directory</ulink>. | 1866 | Yocto Project Build Directory</ulink>. |
| 1864 | </para> | 1867 | </para> |
| 1865 | 1868 | ||
| @@ -1867,7 +1870,7 @@ FILESPATH = "${@base_set_filespath([ "${FILE_DIRNAME}/${PF}", \ | |||
| 1867 | If you want to establish this directory in a location other than the | 1870 | If you want to establish this directory in a location other than the |
| 1868 | default, you can uncomment the following statement in the | 1871 | default, you can uncomment the following statement in the |
| 1869 | <filename>conf/local.conf</filename> file in the | 1872 | <filename>conf/local.conf</filename> file in the |
| 1870 | <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#yocto-project-files'> | 1873 | <ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-files'> |
| 1871 | Yocto Project Files</ulink>: | 1874 | Yocto Project Files</ulink>: |
| 1872 | <literallayout class='monospaced'> | 1875 | <literallayout class='monospaced'> |
| 1873 | #TMPDIR = "${TOPDIR}/tmp" | 1876 | #TMPDIR = "${TOPDIR}/tmp" |
| @@ -1880,7 +1883,7 @@ FILESPATH = "${@base_set_filespath([ "${FILE_DIRNAME}/${PF}", \ | |||
| 1880 | <glossdef> | 1883 | <glossdef> |
| 1881 | <para> | 1884 | <para> |
| 1882 | This variable is the | 1885 | This variable is the |
| 1883 | <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#yocto-project-build-directory'> | 1886 | <ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-build-directory'> |
| 1884 | Yocto Project Build Directory</ulink>. | 1887 | Yocto Project Build Directory</ulink>. |
| 1885 | BitBake automatically sets this variable. | 1888 | BitBake automatically sets this variable. |
| 1886 | The Yocto Project build system uses the build directory when building images. | 1889 | The Yocto Project build system uses the build directory when building images. |
| @@ -1928,10 +1931,10 @@ FILESPATH = "${@base_set_filespath([ "${FILE_DIRNAME}/${PF}", \ | |||
| 1928 | ${TMPDIR}/work/${PACKAGE_ARCH}-poky-${TARGET_OS}/${PN}-${PV}-${PR} | 1931 | ${TMPDIR}/work/${PACKAGE_ARCH}-poky-${TARGET_OS}/${PN}-${PV}-${PR} |
| 1929 | </literallayout> | 1932 | </literallayout> |
| 1930 | As an example, assume a | 1933 | As an example, assume a |
| 1931 | <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#yocto-project-files'> | 1934 | <ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-files'> |
| 1932 | Yocto Project Files</ulink> top-level directory named <filename>poky</filename> | 1935 | Yocto Project Files</ulink> top-level directory named <filename>poky</filename> |
| 1933 | and a default | 1936 | and a default |
| 1934 | <ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#yocto-project-build-directory'> | 1937 | <ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-build-directory'> |
| 1935 | Yocto Project Build Directory</ulink> of <filename>poky/build</filename>. | 1938 | Yocto Project Build Directory</ulink> of <filename>poky/build</filename>. |
| 1936 | In this case, the working directory the build system uses to build | 1939 | In this case, the working directory the build system uses to build |
| 1937 | the <filename>v86d</filename> package is the following: | 1940 | the <filename>v86d</filename> package is the following: |
diff --git a/documentation/poky-ref-manual/ref-varlocality.xml b/documentation/poky-ref-manual/ref-varlocality.xml index dcf4e7be1e..60cb998160 100644 --- a/documentation/poky-ref-manual/ref-varlocality.xml +++ b/documentation/poky-ref-manual/ref-varlocality.xml | |||
| @@ -1,5 +1,6 @@ | |||
| 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 3 | 4 | ||
| 4 | <appendix id='ref-varlocality'> | 5 | <appendix id='ref-varlocality'> |
| 5 | <title>Reference: Variable Context</title> | 6 | <title>Reference: Variable Context</title> |
diff --git a/documentation/poky-ref-manual/resources.xml b/documentation/poky-ref-manual/resources.xml index a3b5e0806f..5dc6153bcb 100644 --- a/documentation/poky-ref-manual/resources.xml +++ b/documentation/poky-ref-manual/resources.xml | |||
| @@ -1,5 +1,6 @@ | |||
| 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 3 | 4 | ||
| 4 | <appendix id='resources'> | 5 | <appendix id='resources'> |
| 5 | <title>Contributing to the Yocto Project</title> | 6 | <title>Contributing to the Yocto Project</title> |
| @@ -10,8 +11,8 @@ | |||
| 10 | The Yocto Project team is happy for people to experiment with the Yocto Project. | 11 | The Yocto Project team is happy for people to experiment with the Yocto Project. |
| 11 | A number of places exist to find help if you run into difficulties or find bugs. | 12 | A number of places exist to find help if you run into difficulties or find bugs. |
| 12 | To find out how to download source code, | 13 | To find out how to download source code, |
| 13 | see the "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#local-yp-release'>Yocto Project Release</ulink>" | 14 | see the "<ulink url='&YOCTO_DOCS_DEV_URL;#local-yp-release'>Yocto Project Release</ulink>" |
| 14 | list item in The Yocto Project Development Manual. | 15 | list item in the Yocto Project Development Manual. |
| 15 | </para> | 16 | </para> |
| 16 | </section> | 17 | </section> |
| 17 | 18 | ||
| @@ -20,7 +21,7 @@ | |||
| 20 | 21 | ||
| 21 | <para> | 22 | <para> |
| 22 | If you find problems with the Yocto Project, you should report them using the | 23 | If you find problems with the Yocto Project, you should report them using the |
| 23 | Bugzilla application at <ulink url='http://bugzilla.yoctoproject.org/'></ulink>. | 24 | Bugzilla application at <ulink url='&YOCTO_BUGZILLA_URL;'></ulink>. |
| 24 | </para> | 25 | </para> |
| 25 | </section> | 26 | </section> |
| 26 | 27 | ||
| @@ -31,13 +32,13 @@ | |||
| 31 | To subscribe to the Yocto Project mailing lists, click on the following URLs and follow the instructions: | 32 | To subscribe to the Yocto Project mailing lists, click on the following URLs and follow the instructions: |
| 32 | <itemizedlist> | 33 | <itemizedlist> |
| 33 | <listitem><para><emphasis> | 34 | <listitem><para><emphasis> |
| 34 | <ulink url='http://lists.yoctoproject.org/listinfo/yocto-announce'></ulink></emphasis>: | 35 | <ulink url='&YOCTO_LISTS_URL;/listinfo/yocto-announce'></ulink></emphasis>: |
| 35 | Use this list to receive offical Yocto Project announcements for developments and | 36 | Use this list to receive offical Yocto Project announcements for developments and |
| 36 | to learn about Yocto Project milestones.</para></listitem> | 37 | to learn about Yocto Project milestones.</para></listitem> |
| 37 | <listitem><para><emphasis><ulink url='http://lists.yoctoproject.org/listinfo/yocto'></ulink></emphasis>: | 38 | <listitem><para><emphasis><ulink url='&YOCTO_LISTS_URL;/listinfo/yocto'></ulink></emphasis>: |
| 38 | Use this list to monitor Yocto Project development discussions, ask questions, and | 39 | Use this list to monitor Yocto Project development discussions, ask questions, and |
| 39 | get help.</para></listitem> | 40 | get help.</para></listitem> |
| 40 | <listitem><para><emphasis><ulink url='http://lists.yoctoproject.org/listinfo/poky'></ulink></emphasis>: | 41 | <listitem><para><emphasis><ulink url='&YOCTO_LISTS_URL;/listinfo/poky'></ulink></emphasis>: |
| 41 | Use this list to monitor discussions about the Yocto Project build system Poky, | 42 | Use this list to monitor discussions about the Yocto Project build system Poky, |
| 42 | ask questions, and get help.</para></listitem> | 43 | ask questions, and get help.</para></listitem> |
| 43 | </itemizedlist> | 44 | </itemizedlist> |
| @@ -62,15 +63,15 @@ | |||
| 62 | <para> | 63 | <para> |
| 63 | Following is a list of resources you will find helpful: | 64 | Following is a list of resources you will find helpful: |
| 64 | <itemizedlist> | 65 | <itemizedlist> |
| 65 | <listitem><para><emphasis><ulink url='http://yoctoproject.org'>The Yocto Project website</ulink>: | 66 | <listitem><para><emphasis><ulink url='&YOCTO_HOME_URL;'>The Yocto Project website</ulink>: |
| 66 | </emphasis> The home site for the Yocto Project.</para></listitem> | 67 | </emphasis> The home site for the Yocto Project.</para></listitem> |
| 67 | <listitem><para><emphasis><ulink url='http://www.openedhand.com/'>OpenedHand</ulink>:</emphasis> | 68 | <listitem><para><emphasis><ulink url='&OH_HOME_URL;'>OpenedHand</ulink>:</emphasis> |
| 68 | The company where the Yocto Project build system Poky was first developed. | 69 | The company where the Yocto Project build system Poky was first developed. |
| 69 | OpenedHand has since been acquired by Intel Corporation.</para></listitem> | 70 | OpenedHand has since been acquired by Intel Corporation.</para></listitem> |
| 70 | <listitem><para><emphasis><ulink url='http://www.intel.com/'>Intel Corporation</ulink>:</emphasis> | 71 | <listitem><para><emphasis><ulink url='http://www.intel.com/'>Intel Corporation</ulink>:</emphasis> |
| 71 | The company who acquired OpenedHand in 2008 and continues development on the | 72 | The company who acquired OpenedHand in 2008 and continues development on the |
| 72 | Yocto Project.</para></listitem> | 73 | Yocto Project.</para></listitem> |
| 73 | <listitem><para><emphasis><ulink url='http://www.openembedded.org/'>OpenEmbedded</ulink>:</emphasis> | 74 | <listitem><para><emphasis><ulink url='&OE_HOME_URL;'>OpenEmbedded</ulink>:</emphasis> |
| 74 | The upstream, generic, embedded distribution the Yocto Project build system (Poky) derives | 75 | The upstream, generic, embedded distribution the Yocto Project build system (Poky) derives |
| 75 | from and to which it contributes.</para></listitem> | 76 | from and to which it contributes.</para></listitem> |
| 76 | <listitem><para><emphasis><ulink url='http://developer.berlios.de/projects/bitbake/'> | 77 | <listitem><para><emphasis><ulink url='http://developer.berlios.de/projects/bitbake/'> |
| @@ -95,8 +96,8 @@ | |||
| 95 | You can submit changes to the project either by creating and sending pull requests, | 96 | You can submit changes to the project either by creating and sending pull requests, |
| 96 | or by submitting patches through email. | 97 | or by submitting patches through email. |
| 97 | For information on how to do both, see the | 98 | For information on how to do both, see the |
| 98 | "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#how-to-submit-a-change'>How to Submit a Change</ulink>" | 99 | "<ulink url='&YOCTO_DOCS_DEV_URL;#how-to-submit-a-change'>How to Submit a Change</ulink>" |
| 99 | section in The Yocto Project Development Manual. | 100 | section in the Yocto Project Development Manual. |
| 100 | </para> | 101 | </para> |
| 101 | </section> | 102 | </section> |
| 102 | 103 | ||
diff --git a/documentation/poky-ref-manual/technical-details.xml b/documentation/poky-ref-manual/technical-details.xml index 840c9e3e7a..af62ee4f35 100644 --- a/documentation/poky-ref-manual/technical-details.xml +++ b/documentation/poky-ref-manual/technical-details.xml | |||
| @@ -1,5 +1,7 @@ | |||
| 1 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 4 | |||
| 3 | <chapter id='technical-details'> | 5 | <chapter id='technical-details'> |
| 4 | <title>Technical Details</title> | 6 | <title>Technical Details</title> |
| 5 | 7 | ||
| @@ -31,16 +33,16 @@ | |||
| 31 | Configuration data acts as the glue to bind everything together.</para></listitem> | 33 | Configuration data acts as the glue to bind everything together.</para></listitem> |
| 32 | </itemizedlist> | 34 | </itemizedlist> |
| 33 | For more information on data, see the | 35 | For more information on data, see the |
| 34 | "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#yocto-project-terms'>Yocto Project Terms</ulink>" | 36 | "<ulink url='&YOCTO_DOCS_DEV_URL;#yocto-project-terms'>Yocto Project Terms</ulink>" |
| 35 | section in The Yocto Project Development Manual. | 37 | section in the Yocto Project Development Manual. |
| 36 | </para> | 38 | </para> |
| 37 | 39 | ||
| 38 | <para> | 40 | <para> |
| 39 | BitBake knows how to combine multiple data sources together and refers to each data source | 41 | BitBake knows how to combine multiple data sources together and refers to each data source |
| 40 | as a layer. | 42 | as a layer. |
| 41 | For information on layers, see the | 43 | For information on layers, see the |
| 42 | "<ulink url='http://www.yoctoproject.org/docs/latest/dev-manual/dev-manual.html#understanding-and-creating-layers'>Understanding and Creating Layers</ulink>" | 44 | "<ulink url='&YOCTO_DOCS_DEV_URL;#understanding-and-creating-layers'>Understanding and |
| 43 | section of the Yocto Project Development Manual. | 45 | Creating Layers</ulink>" section of the Yocto Project Development Manual. |
| 44 | </para> | 46 | </para> |
| 45 | 47 | ||
| 46 | <para> | 48 | <para> |
| @@ -562,7 +564,7 @@ | |||
| 562 | <note> | 564 | <note> |
| 563 | For an example of a commit that makes a cosmetic change to invalidate | 565 | For an example of a commit that makes a cosmetic change to invalidate |
| 564 | a shared state, see this | 566 | a shared state, see this |
| 565 | <ulink url='http://git.yoctoproject.org/cgit.cgi/poky/commit/meta/classes/package.bbclass?id=737f8bbb4f27b4837047cb9b4fbfe01dfde36d54'>commit</ulink>. | 567 | <ulink url='&YOCTO_GIT_URL;/cgit.cgi/poky/commit/meta/classes/package.bbclass?id=737f8bbb4f27b4837047cb9b4fbfe01dfde36d54'>commit</ulink>. |
| 566 | </note> | 568 | </note> |
| 567 | </section> | 569 | </section> |
| 568 | </section> | 570 | </section> |
| @@ -623,10 +625,10 @@ | |||
| 623 | 625 | ||
| 624 | <para> | 626 | <para> |
| 625 | In this example, the first line locates a file in | 627 | In this example, the first line locates a file in |
| 626 | <filename><link linkend='var-S'>S</link>/src/ls.c</filename>. | 628 | <filename>${S}/src/ls.c</filename>. |
| 627 | The second line refers to a file in | 629 | The second line refers to a file in |
| 628 | <filename><link linkend='var-WORKDIR'>WORKDIR</link></filename>, which is the parent | 630 | <filename><link linkend='var-WORKDIR'>WORKDIR</link></filename>, which is the parent |
| 629 | of <filename>S</filename>. | 631 | of <filename><link linkend='var-S'>S</link></filename>. |
| 630 | </para> | 632 | </para> |
| 631 | <para> | 633 | <para> |
| 632 | Note that this variable is mandatory for all recipes, unless the | 634 | Note that this variable is mandatory for all recipes, unless the |
diff --git a/documentation/poky-ref-manual/usingpoky.xml b/documentation/poky-ref-manual/usingpoky.xml index 8dddb7a755..c80b080cc8 100644 --- a/documentation/poky-ref-manual/usingpoky.xml +++ b/documentation/poky-ref-manual/usingpoky.xml | |||
| @@ -1,5 +1,7 @@ | |||
| 1 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | ||
| 4 | |||
| 3 | <chapter id='usingpoky'> | 5 | <chapter id='usingpoky'> |
| 4 | <title>Using the Yocto Project</title> | 6 | <title>Using the Yocto Project</title> |
| 5 | 7 | ||
| @@ -15,7 +17,7 @@ | |||
| 15 | <para> | 17 | <para> |
| 16 | You can find general information on how to build an image using the | 18 | You can find general information on how to build an image using the |
| 17 | Yocto Project in the | 19 | Yocto Project in the |
| 18 | "<ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#building-image'>Building an Image</ulink>" | 20 | "<ulink url='&YOCTO_DOCS_QS_URL;#building-image'>Building an Image</ulink>" |
| 19 | section of The Yocto Project Quick Start. | 21 | section of The Yocto Project Quick Start. |
| 20 | This section provides a summary of the build process and provides information | 22 | This section provides a summary of the build process and provides information |
| 21 | for less obvious aspects of the build process. | 23 | for less obvious aspects of the build process. |
| @@ -91,8 +93,8 @@ | |||
| 91 | <filename class="directory">tmp/deploy/images</filename>. | 93 | <filename class="directory">tmp/deploy/images</filename>. |
| 92 | For information on how to run pre-built images such as <filename>qemux86</filename> | 94 | For information on how to run pre-built images such as <filename>qemux86</filename> |
| 93 | and <filename>qemuarm</filename>, see the | 95 | and <filename>qemuarm</filename>, see the |
| 94 | "<ulink url='http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#using-pre-built'>Using Pre-Built Binaries and QEMU</ulink>" | 96 | "<ulink url='&YOCTO_DOCS_QS_URL;#using-pre-built'>Using Pre-Built Binaries and QEMU</ulink>" |
| 95 | section in The Yocto Project Quick Start. | 97 | section in the Yocto Project Quick Start. |
| 96 | For information about how to install these images, see the documentation for your | 98 | For information about how to install these images, see the documentation for your |
| 97 | particular board/machine. | 99 | particular board/machine. |
| 98 | </para> | 100 | </para> |
