diff options
-rw-r--r-- | documentation/adt-manual/adt-eclipse.xml | 2 | ||||
-rw-r--r-- | documentation/dev-manual/dev-manual-bsp-appendix.xml | 20 | ||||
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 4 | ||||
-rw-r--r-- | documentation/dev-manual/dev-manual-kernel-appendix.xml | 28 | ||||
-rw-r--r-- | documentation/dev-manual/dev-manual-model.xml | 3 | ||||
-rw-r--r-- | documentation/dev-manual/dev-manual-newbie.xml | 3 | ||||
-rw-r--r-- | documentation/dev-manual/dev-manual-start.xml | 14 |
7 files changed, 39 insertions, 35 deletions
diff --git a/documentation/adt-manual/adt-eclipse.xml b/documentation/adt-manual/adt-eclipse.xml index 3a6dce5da7..aead5d8ee2 100644 --- a/documentation/adt-manual/adt-eclipse.xml +++ b/documentation/adt-manual/adt-eclipse.xml @@ -324,7 +324,7 @@ </para></listitem> <listitem><para><emphasis>Point to the Toolchain:</emphasis> If you are using a stand-alone pre-built toolchain, you should be pointing to the - <filename>/opt/poky/1.1</filename> directory. + <filename>&YOCTO_ADTPATH_DIR;</filename> directory. This is the location for toolchains installed by the ADT Installer or by hand. Sections "<link linkend='configuring-and-running-the-adt-installer-script'>Configuring and Running the ADT Installer Script</link>" and diff --git a/documentation/dev-manual/dev-manual-bsp-appendix.xml b/documentation/dev-manual/dev-manual-bsp-appendix.xml index fef07e5797..25f74763b1 100644 --- a/documentation/dev-manual/dev-manual-bsp-appendix.xml +++ b/documentation/dev-manual/dev-manual-bsp-appendix.xml @@ -43,7 +43,7 @@ $ git clone git://git.yoctoproject.org/poky $ cd poky </literallayout> - Alternatively, you can start with the downloaded Poky "edison" tarball. + Alternatively, you can start with the downloaded Poky "&DISTRO_NAME;" tarball. These commands unpack the tarball into a Yocto Project File directory structure. By default, the top-level directory of the file structure is named <filename>poky-&YOCTO_POKY;</filename>: @@ -54,7 +54,7 @@ <note><para>If you're using the tarball method, you can ignore all the following steps that ask you to carry out Git operations. You already have the results of those operations - in the form of the edison release tarballs. + in the form of the &DISTRO_NAME; release tarballs. Consequently, there is nothing left to do other than extract those tarballs into the proper locations.</para> @@ -160,7 +160,7 @@ $ cd meta-intel </literallayout> Alternatively, you can start with the downloaded Crown Bay tarball. - You can download the edison version of the BSP tarball from the + You can download the &DISTRO_NAME; version of the BSP tarball from the <ulink url='&YOCTO_HOME_URL;/download'>Download</ulink> page of the Yocto Project website. Here is the specific link for the tarball needed for this example: @@ -177,7 +177,7 @@ The <filename>meta-intel</filename> directory contains all the metadata that supports BSP creation. If you're using the Git method, the following - step will switch to the edison metadata. + step will switch to the &DISTRO_NAME; metadata. If you're using the tarball method, you already have the correct metadata and can skip to the next step. Because <filename>meta-intel</filename> is its own Git repository, you will want @@ -445,11 +445,11 @@ and insert the commit identifiers to identify the kernel in which we are interested, which will be based on the <filename>atom-pc-standard</filename> kernel. - In this case, because we're working with the edison branch of everything, we + In this case, because we're working with the &DISTRO_NAME; branch of everything, we need to use the <filename>SRCREV</filename> values for the atom-pc branch - that are associated with the edison release. + that are associated with the &DISTRO_NAME; release. To find those values, we need to find the <filename>SRCREV</filename> - values that edison uses for the atom-pc branch, which we find in the + values that &DISTRO_NAME; uses for the atom-pc branch, which we find in the <filename>poky/meta-yocto/recipes-kernel/linux/linux-yocto_3.0.bbappend</filename> file. </para> @@ -474,8 +474,8 @@ <para> In this example, we're using the <filename>SRCREV</filename> values we - found already captured in the edison release because we're creating a BSP based on - edison. + found already captured in the &DISTRO_NAME; release because we're creating a BSP based on + &DISTRO_NAME;. If, instead, we had based our BSP on the master branches, we would want to use the most recent <filename>SRCREV</filename> values taken directly from the kernel repo. We will not be doing that for this example. @@ -682,7 +682,7 @@ </para> <para> - For reference, the sato image produced by the previous steps for edison + For reference, the sato image produced by the previous steps for &DISTRO_NAME; should look like the following in terms of size. If your sato image is much different from this, you probably made a mistake in one of the above steps: diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 7fd19cb54c..971a63655e 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -248,8 +248,8 @@ <para> Append files files must have the same name as the underlying recipe. - For example, the append file <filename>someapp_1.1.bbappend</filename> must - apply to <filename>someapp_1.1.bb</filename>. + For example, the append file <filename>someapp_&DISTRO;.bbappend</filename> must + apply to <filename>someapp_&DISTRO;.bb</filename>. This means the original recipe and append file names are version number specific. If the underlying recipe is renamed to update to a newer version, the corresponding <filename>.bbappend</filename> file must be renamed as well. diff --git a/documentation/dev-manual/dev-manual-kernel-appendix.xml b/documentation/dev-manual/dev-manual-kernel-appendix.xml index 58f33e8ef3..865c43b3ec 100644 --- a/documentation/dev-manual/dev-manual-kernel-appendix.xml +++ b/documentation/dev-manual/dev-manual-kernel-appendix.xml @@ -155,13 +155,13 @@ $ git branch -a $ git tag -l </literallayout> - This example uses the Yocto Project 1.1 Release code named "edison", - which maps to the <filename>edison</filename> branch in the repository. - The following commands create and checkout the local <filename>edison</filename> + This example uses the Yocto Project &DISTRO; Release code named "&DISTRO_NAME;", + which maps to the <filename>&DISTRO_NAME;</filename> branch in the repository. + The following commands create and checkout the local <filename>&DISTRO_NAME;</filename> branch: <literallayout class='monospaced'> $ git checkout -b &DISTRO_NAME; origin/&DISTRO_NAME; - Branch edison set up to track remote branch &DISTRO_NAME; from origin. + Branch &DISTRO_NAME; set up to track remote branch &DISTRO_NAME; from origin. Switched to a new branch '&DISTRO_NAME;' </literallayout> </para> @@ -184,7 +184,7 @@ <title>Setting Up the Bare Clone and its Copy</title> <para> - This example modifies the <filename>linux-yocto-3.0-1.1.x</filename> kernel. + This example modifies the <filename>linux-yocto-3.2</filename> kernel. Thus, you need to create a bare clone of that kernel and then make a copy of the bare clone. See the bulleted item @@ -196,12 +196,12 @@ The bare clone exists for the kernel build tools and simply as the receiving end of <filename>git push</filename> commands after you make edits and commits inside the copy of the clone. - The copy (<filename>my-linux-yocto-3.0-1.1.x-work</filename> in this example) has to have + The copy (<filename>my-linux-yocto-3.2-work</filename> in this example) has to have a local branch created and checked out for your work. This example uses <filename>common-pc-base</filename> as the local branch. The following commands create and checkout the branch: <literallayout class='monospaced'> - $ cd ~/my-linux-yocto-3.0-1.1.x-work + $ cd ~/my-linux-yocto-3.2-work $ git checkout -b common-pc-base origin/yocto/standard/common-pc/base Branch common-pc-base set up to track remote branch yocto/standard/common-pc/base from origin. @@ -296,7 +296,7 @@ <para> The file you change in this example is named <filename>calibrate.c</filename> - and is located in the <filename>my-linux-yocto-3.0-1.1.x-work</filename> Git repository + and is located in the <filename>my-linux-yocto-3.2-work</filename> Git repository (the copy of the bare clone) in <filename>init</filename>. This example simply inserts several <filename>printk</filename> statements at the beginning of the <filename>calibrate_delay</filename> function. @@ -420,13 +420,13 @@ <filename>poky-extras/meta-kernel-dev/recipes-kernel/linux</filename> directory, you need to identify the location of the local source code, which in this example is the bare clone named - <filename>linux-yocto-3.0-1.1.x.git</filename>. + <filename>linux-yocto-3.2.git</filename>. To do this, set the <filename>KSRC_linux_yocto</filename> variable to point to your - local <filename>linux-yocto-3.0-1.1.x.git</filename> Git repository by adding the + local <filename>linux-yocto-3.2.git</filename> Git repository by adding the following statement. Be sure to substitute your user information in the statement: <literallayout class='monospaced'> - KSRC_linux_yocto ?= /home/scottrif/linux-yocto-3.0-1.1.x.git + KSRC_linux_yocto ?= /home/scottrif/linux-yocto-3.2.git </literallayout></para></listitem> <listitem><para><emphasis>Specify the Kernel Machine:</emphasis> Also in the <filename>linux-yocto_3.0.bbappend</filename> file, you need to specify @@ -545,13 +545,13 @@ $ git branch -a $ git tag -l </literallayout> - This example uses the Yocto Project 1.1.1 Release code named "&DISTRO_NAME;", + This example uses the Yocto Project &DISTRO; Release code named "&DISTRO_NAME;", which maps to the <filename>&DISTRO_NAME;</filename> branch in the repository. The following commands create and checkout the local <filename>&DISTRO_NAME;</filename> branch: <literallayout class='monospaced'> $ git checkout -b &DISTRO_NAME; origin/&DISTRO_NAME; - Branch edison set up to track remote branch &DISTRO_NAME; from origin. + Branch &DISTRO_NAME; set up to track remote branch &DISTRO_NAME; from origin. Switched to a new branch '&DISTRO_NAME;' </literallayout> </para> @@ -654,7 +654,7 @@ <para> After setting up the environment to run <filename>menuconfig</filename>, you are ready to use the tool to interactively change the kernel configuration. - In this example, we are basing our changes on the <filename>linux-yocto-3.0-1.1.x</filename> + In this example, we are basing our changes on the <filename>linux-yocto-3.2</filename> kernel. The Yocto Project build environment recognizes this kernel as <filename>linux-yocto</filename>. diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml index 29840ee720..1950210644 100644 --- a/documentation/dev-manual/dev-manual-model.xml +++ b/documentation/dev-manual/dev-manual-model.xml @@ -247,6 +247,9 @@ <listitem><para><emphasis><filename>linux-yocto-3.0-1.1.x</filename></emphasis> - The stable Linux Yocto kernel to use with the Yocto Project Release 1.1.x. This kernel is based on the Linux 3.0 release</para></listitem> + <listitem><para><emphasis><filename>linux-yocto-3.2</filename></emphasis> - The + stable Linux Yocto kernel to use with the Yocto Project Release 1.2. This kernel + is based on the Linux 3.2 release</para></listitem> <listitem><para><emphasis><filename>linux-yocto-dev</filename></emphasis> - A development kernel based on the latest upstream release candidate available.</para></listitem> </itemizedlist> diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml index 0cf9f3110f..132888a196 100644 --- a/documentation/dev-manual/dev-manual-newbie.xml +++ b/documentation/dev-manual/dev-manual-newbie.xml @@ -494,7 +494,8 @@ Git uses "branches" to organize different development efforts. For example, the <filename>poky</filename> repository has <filename>laverne</filename>, <filename>bernard</filename>, - <filename>edison</filename>, and <filename>master</filename> branches among + <filename>edison</filename>, <filename>denzil</filename> and + <filename>master</filename> branches among others. You can see all the branches by going to <ulink url='&YOCTO_GIT_URL;/cgit.cgi/poky/'></ulink> and diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index 02f6599179..791315c960 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml @@ -132,18 +132,18 @@ For simplicity, it is recommended that you create these structures outside of the Yocto Project Files Git repository.</para> <para>As an example, the following transcript shows how to create the bare clone - of the <filename>linux-yocto-3.0-1.1.x</filename> kernel and then create a copy of + of the <filename>linux-yocto-3.2</filename> kernel and then create a copy of that clone. <note>When you have a local Linux Yocto kernel Git repository, you can reference that repository rather than the upstream Git repository as part of the <filename>clone</filename> command. Doing so can speed up the process.</note></para> <para>In the following example, the bare clone is named - <filename>linux-yocto-3.0-1.1.x.git</filename>, while the - copy is named <filename>my-linux-yocto-3.0-1.1.x-work</filename>: + <filename>linux-yocto-3.2.git</filename>, while the + copy is named <filename>my-linux-yocto-3.2-work</filename>: <literallayout class='monospaced'> - $ git clone --bare git://git.yoctoproject.org/linux-yocto-3.0-1.1.x linux-yocto-3.0-1.1.x.git - Initialized empty Git repository in /home/scottrif/linux-yocto-3.0-1.1.x.git/ + $ git clone --bare git://git.yoctoproject.org/linux-yocto-3.2 linux-yocto-3.2.git + Initialized empty Git repository in /home/scottrif/linux-yocto-3.2.git/ remote: Counting objects: 2259181, done. remote: Compressing objects: 100% (373259/373259), done. remote: Total 2259181 (delta 1892638), reused 2231556 (delta 1865300) @@ -152,8 +152,8 @@ </literallayout></para> <para>Now create a clone of the bare clone just created: <literallayout class='monospaced'> - $ git clone linux-yocto-3.0-1.1.x.git my-linux-yocto-3.0-1.1.x-work - Initialized empty Git repository in /home/scottrif/my-linux-yocto-3.0-1.1.x/.git/ + $ git clone linux-yocto-3.2.git my-linux-yocto-3.2-work + Initialized empty Git repository in /home/scottrif/my-linux-yocto-3.2/.git/ Checking out files: 100% (36898/36898), done. </literallayout></para></listitem> <listitem id='poky-extras-repo'><para><emphasis> |