diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2012-03-09 17:38:00 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2012-03-23 14:24:44 +0000 |
commit | 9bdc18a82017d549217a813a6da5d1267fb737e3 (patch) | |
tree | 5dfc02f96e623ecf40df721f946199fb0729a0dc | |
parent | 9602c5556baf60040fde5710564129633f7e9c4c (diff) | |
download | poky-9bdc18a82017d549217a813a6da5d1267fb737e3.tar.gz |
documentation/poky-ref-manual: Converted to use poky.ent variables.
Fixed all the hard links to use appropriate variables from the
file poky.ent.
(From yocto-docs rev: 9a6267d0d843dc47c1171eba6200387901b77df4)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-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> |