From 9f478d13585ca0ae129ffdb71a1b68b0202a2465 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 3 Jan 2018 12:56:07 -0800 Subject: dev-manual, ref-manual: Moved source file sections The sections in the introductory chapter of the ref-manual are better served as part of the dev-manual. These sections are about accessing YP source files using various methods (i.e. source repositories, index of releases, and nightly builds). I have integrated that information into the dev-manual where the information was also being treated. (From yocto-docs rev: d3a97b1f9367d5bb5370974c8c5c0404df86724a) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/dev-manual/dev-manual-start.xml | 85 ++++++++++++++++++++------- documentation/ref-manual/introduction.xml | 50 ---------------- 2 files changed, 65 insertions(+), 70 deletions(-) diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index 195b22d0b1..ff8b56e62b 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml @@ -278,9 +278,20 @@ Accessing Source Repositories - Yocto Project maintains upstream Git + Working from a copy of the upstream Yocto Project Source Repositories - that you can examine and access using a browser-based UI: + is the preferred method for obtaining and using a Yocto Project + release. + You can view the Yocto Project Source Repositories at + . + In particular, you can find the + poky repository at + . + + + + Use the following procedure to locate the latest upstream copy of + the poky Git repository: Access Repositories: @@ -290,8 +301,8 @@ repositories. - Select a Repository: - Click on any repository in which you are interested (e.g. + Select the Repository: + Click on the repository in which you are interested (i.e. poky). @@ -300,14 +311,11 @@ clone that repository (e.g. &YOCTO_GIT_URL;/poky). - - - Examine Change History of the Repository: - At the top of the page, click on any branch in which you - might be interested (e.g. - &DISTRO_NAME_NO_CAP;). - You can then view the commit log or tree view for that - development branch. + + For information on cloning a repository, see the + "Cloning the poky Repository" + section. + @@ -319,12 +327,12 @@ Yocto Project maintains an Index of Releases area that contains related files that contribute to the Yocto Project. - Rather than Git repositories, these files represent snapshot - tarballs. + Rather than Git repositories, these files are tarballs that + represent snapshots in time of a given component. Tip The recommended method for accessing Yocto Project - components is to use Git to clone a repository and work from - within that local repository. + components is to use Git to clone the upstream repository and + work from within that locally cloned repository. The procedure in this section exists should you desire a tarball snapshot of any given component. @@ -342,8 +350,8 @@ full array of released Poky tarballs. The poky directory in the Index of Releases was historically used for very - early releases and exists for retroactive - completeness only. + early releases and exists now only for retroactive + completeness. @@ -361,7 +369,7 @@ Download the Tarball: - Click a tarball to download and save a snapshot of a + Click the tarball to download and save a snapshot of the given component. @@ -398,7 +406,7 @@ Select the Type of Files: - Click the type of files you want (i.e "Build System", + Click the type of files you want such as "Build System", "Tools", or "Board Support Packages (BSPs)". @@ -410,6 +418,43 @@ +
+ Accessing Nightly Builds + + + Yocto Project maintains an area for nightly builds that contains + tarball releases at . + These builds include Yocto Project releases, SDK installation + scripts, and experimental builds. + + + + Should you ever want to access a nightly build of a particular + Yocto Project component, use the following procedure: + + + Access the Nightly Builds: + Open a browser and go to + to access the + Nightly Builds. + + + Select a Build: + Click on any build by date in which you are interested. + + + Find the Tarball: + Drill down to find the associated tarball. + + + Download the Tarball: + Click the tarball to download and save a snapshot of the + given component. + + + +
+
Cloning the <filename>poky</filename> Repository diff --git a/documentation/ref-manual/introduction.xml b/documentation/ref-manual/introduction.xml index 1ccab188ec..3f55e73100 100644 --- a/documentation/ref-manual/introduction.xml +++ b/documentation/ref-manual/introduction.xml @@ -618,56 +618,6 @@
-
- Obtaining the Yocto Project - - The Yocto Project development team makes the Yocto Project available through a number - of methods: - - Source Repositories: - Working from a copy of the upstream - poky repository is the - preferred method for obtaining and using a Yocto Project - release. - You can view the Yocto Project Source Repositories at - . - In particular, you can find the - poky repository at - . - - Releases: Stable, tested - releases are available as tarballs through - . - Nightly Builds: These - tarball releases are available at - . - These builds include Yocto Project releases, SDK installation - scripts, and experimental builds. - - Yocto Project Website: You can - find tarball releases of the Yocto Project and supported BSPs - at the - Yocto Project website. - Along with these downloads, you can find lots of other - information at this site. - - - -
- -
- Development Checkouts - - Development using the Yocto Project requires a local - Source Directory. - You can set up the Source Directory by cloning a copy of the upstream - poky Git repository. - For information on how to do this, see the - "Working With Yocto Project Source Files" - section in the Yocto Project Development Tasks Manual. - -
-
Yocto Project Terms -- cgit v1.2.3-54-g00ecf