From aa3a201629c7e40341f53d4be57b6e4223a845c8 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 9 Mar 2012 13:40:39 -0600 Subject: documentation/dev-manual: Converted to use poky.ent I converted the hard links to use the variables as established in the file poky.ent. Also, Cleaned up some bad text in the term "Yocto Project Files." Looks like a cut-and-paste problem. (From yocto-docs rev: e2e20bf4895d80dae73595e93132f37fb31121d1) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/dev-manual/dev-manual-newbie.xml | 129 +++++++++++-------------- 1 file changed, 56 insertions(+), 73 deletions(-) (limited to 'documentation/dev-manual/dev-manual-newbie.xml') diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml index cf6f700377..1da05e20df 100644 --- a/documentation/dev-manual/dev-manual-newbie.xml +++ b/documentation/dev-manual/dev-manual-newbie.xml @@ -1,5 +1,6 @@ +"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" +[ %poky; ] > @@ -122,7 +123,7 @@ The Yocto Project team maintains complete source repositories for all Yocto Project files - at . + at . This web-based source code browser is organized into categories by function such as IDE Plugins, Matchbox, Poky, Yocto Linux Kernel, and so forth. From the interface, you can click on any particular item in the "Name" column and @@ -143,7 +144,7 @@ For any supported release of Yocto Project, you can go to the Yocto Project website’s - download page and get a + download page and get a tarball of the release. You can also go to this site to download any supported BSP tarballs. Unpacking the tarball gives you a hierarchical directory structure of Yocto Project @@ -158,14 +159,14 @@ In summary, here is where you can get the Yocto Project files needed for development: - Source Repositories: + Source Repositories: This area contains IDE Plugins, Matchbox, Poky, Poky Support, Tools, Yocto Linux Kernel, and Yocto Metadata Layers. You can create Git repositories for each of these areas. - Index of /releases: + Index of /releases: This area contains index releases such as the Eclipse Yocto Plug-in, miscellaneous support, Poky, pseudo, cross-development toolchains, @@ -175,11 +176,11 @@ - Yocto Project Download Page + Yocto Project Download Page This page on the Yocto Project website allows you to download any Yocto Project release or Board Support Package (BSP) in tarball form. The tarballs are similar to those found in the - Index of /releases: area. + Index of /releases: area. @@ -239,12 +240,12 @@ Images are the binary output that runs on specific hardware and for specific use cases. For a list of the supported image types that the Yocto Project provides, see the - "Reference: Images" + "Reference: Images" appendix in The Yocto Project Reference Manual. Layer: A collection of recipes representing the core, a BSP, or an application stack. For a discussion on BSP Layers, see the - "BSP Layers" + "BSP Layers" section in the Yocto Project Board Support Packages (BSP) Developer's Guide. Metadata: The files that BitBake parses when building an image. @@ -283,44 +284,42 @@ by cloning git://git.yoctoproject.org/poky. Sometimes the term "the Yocto Project Files structure" is used as well. - The Yocto Project files contain BitBake, Documentation, metadata and + The Yocto Project Files contain BitBake, Documentation, metadata and other files that all support the development environment. - Consequently, you must have the Yocto Project files in place on your development + Consequently, you must have the Yocto Project Files in place on your development system in order to do any development using the Yocto Project. - The name of the top-level directory of the Yocto Project file structure + The name of the top-level directory of the Yocto Project Files structure is derived from the Yocto Project release tarball. - For example, downloading and unpacking poky-edison-6.0.tar.bz2 + For example, downloading and unpacking &YOCTO_POKY_TARBALL; results in a Yocto Project file structure whose Yocto Project source directory is named - poky-edison-6.0. + &YOCTO_POKY;. If you create a Git repository, then you can name the repository anything you like. - By default, your local Git repository is named poky. + Throughout much of the documentation, the name of the Git repository is used as the + name for the local folder. + So, for example, cloning the poky Git repository results in a + local Git repository also named poky. It is important to understand the differences between Yocto Project Files created by unpacking a release tarball as compared to cloning git://git.yoctoproject.org/poky. When you unpack a tarball, you have an exact copy of the files based on the time of release - a fixed release point. - Any changes you make to your local Yocto Project files are on top of the release. + Any changes you make to your local Yocto Project Files are on top of the release. On the other hand, when you clone the Yocto Project Git repository, you have an active development repository. - creates a build directory named YP-6.0 - in your home directory within the directory mybuilds. - If mybuilds does not exist it is created for you. In this case, any local changes you make to the Yocto Project can be later applied to active - development branches of the upstream Yocto Project Git repository. - If you want to track a set of local changes while starting from the same point + In this case, any local changes you make to the Yocto Project can be later applied + to active development branches of the upstream Yocto Project Git repository. + + Finally, if you want to track a set of local changes while starting from the same point as a release tarball, you can create a local Git branch that reflects the exact copy of the files at the time of their release. - You do this using Git tags that are part of the repository. - For more information on concepts, see the section - "Repositories, Tags, and Branches". - - - You can find instruction on how to set up the Yocto Project files on your - host development system by reading - the - "Getting - Setup" section. + You do this using Git tags that are part of the repository. + + For more information on concepts around Git repositories, branches, and tags, + see the + "Repositories, Tags, and Branches" + section. Yocto Project Build Directory: This term refers to the area used by the Yocto Project for builds. @@ -341,17 +340,17 @@ Provide a directory path and specifically name the build directory. - This next example creates a build directory named YP-6.0 + This next example creates a build directory named YP-&POKYVERSION; in your home directory within the directory mybuilds. If mybuilds does not exist, the directory is created for you: - $ source poky-edison-6.0/oe-init-build-env $HOME/mybuilds/YP-6.0 + $ source &OE_INIT_PATH; $HOME/mybuilds/YP-&POKYVERSION; Provide an existing directory to use as the build directory. This example uses the existing mybuilds directory as the build directory. - $ source poky-edison-6.0/oe-init-build-env $HOME/mybuilds/ + $ source &OE_INIT_PATH; $HOME/mybuilds/ @@ -419,7 +418,7 @@ You can find a list of the combined SPDX and OSI licenses that the Yocto Project uses - here. + here. This wiki page discusses the license infrastructure used by the Yocto Project. @@ -449,7 +448,7 @@ As mentioned earlier in section "Yocto Project Source Repositories", the Yocto Project maintains source repositories at - . + . If you look at this web-interface of the repositories, each item is a separate Git repository. @@ -489,9 +488,9 @@ edison, and master branches among others. You can see all the branches by going to - and + and clicking on the - [...] + [...] link beneath the "Branch" heading. @@ -512,19 +511,19 @@ branch in the repository. To help illustrate, here is a set of commands that creates a local copy of the poky Git repository and then creates and checks out a local - Git branch that tracks the Yocto Project 1.1 Release (edison) development: + Git branch that tracks the Yocto Project &DISTRO; Release (&DISTRO_NAME;) development: $ cd ~ $ git clone git://git.yoctoproject.org/poky $ cd poky - $ git checkout edison -b edison + $ git checkout &DISTRO_NAME; -b &DISTRO_NAME; In this example, the name of the top-level directory of your local Yocto Project Files Git repository is poky. And, the name of the local working area (or local branch) you have created and checked - out is named edison. + out is named &DISTRO_NAME;. The files in your repository now reflect the same files that are in the - edison development branch of the Yocto Project's + &DISTRO_NAME; development branch of the Yocto Project's poky repository. It is important to understand that when you create and checkout a local working branch based on a branch name, @@ -532,8 +531,8 @@ at the time you created your local branch, which could be different than the files at the time of a similarly named release. In other words, creating and checking out a local branch based on the - edison branch name is not the same as creating and - checking out a local branch based on the edison-6.0 + &DISTRO_NAME; branch name is not the same as creating and + checking out a local branch based on the &DISTRO_NAME;-&DISTRO; release. Keep reading to see how you create a local snapshot of a Yocto Project Release. @@ -543,15 +542,15 @@ Typically, a tag is used to mark a special point such as the final change before a project is released. You can see the tags used with the poky Git repository - by going to and + by going to and clicking on the - [...] + [...] link beneath the "Tag" heading. Some key tags are laverne-4.0, bernard-5.0, - and edison-6.0. + and &DISTRO_NAME;-&POKYVERSION;. These tags represent Yocto Project releases. @@ -569,14 +568,14 @@ $ cd ~ $ git clone git://git.yoctoproject.org/poky $ cd poky - $ git checkout edison-6.0 -b edison-6.0 + $ git checkout &DISTRO_NAME;-&POKYVERSION; -b &DISTRO_NAME;-&POKYVERSION; In this example, the name of the top-level directory of your local Yocto Project Files Git repository is poky. And, the name of the local branch you have created and checked out is - edison-6.0. - The files in your repository now exactly match the Yocto Project 1.1 - Release tag (edison). + &DISTRO_NAME;-&POKYVERSION;. + The files in your repository now exactly match the Yocto Project &DISTRO; + Release tag (&DISTRO_NAME;). It is important to understand that when you create and checkout a local working branch based on a tag, your environment matches a specific point in time and not a development branch. @@ -807,7 +806,7 @@ changes, can be used to communicate changes and problems with developers, can be used to submit and review patches, and can be used to manage quality assurance. The home page for the Yocto Project implementation of Bugzilla is - http://bugzilla.yoctoproject.org. + &YOCTO_BUGZILLA_URL;. @@ -818,7 +817,7 @@ Bugzilla. You can find more information on defect management, bug tracking, and feature request processes all accomplished through the Yocto Project Bugzilla on the wiki page - here. + here. Always use the Yocto Project implementation of Bugzilla to submit a bug. @@ -866,7 +865,7 @@ You should send patches to the appropriate Yocto Project mailing list to get them in front of the Yocto Project Maintainer. For a list of the Yocto Project mailing lists, see the - "Mailing lists" section in + "Mailing lists" section in The Yocto Project Reference Manual. @@ -875,14 +874,14 @@ For defects against the Yocto Project build system Poky, send your patch to the - mailing list. + mailing list. This mailing list corresponds to issues that are not specific to the Yocto Project but are part of the OE-core. For example, a defect against anything in the meta layer or the BitBake Manual could be sent to this mailing list. For defects against Yocto-specific layers, tools, and Yocto Project documentation use the - mailing list. + mailing list. This mailing list corresponds to Yocto-specific areas such as meta-yocto, meta-intel, linux-yocto, and documentation. @@ -973,7 +972,7 @@ You can find more guidance on creating well-formed commit messages at this OpenEmbedded wiki page: - . + . @@ -1089,22 +1088,6 @@ - - - - - - - - - - - - - - - -