From ebc7de094881dd8f2450aa4fdf548f2e9c835df1 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Tue, 23 Jan 2018 12:16:28 -0800 Subject: ref-manual, dev-manual: Moved "Speeding Build" to dev-manual Fixes [YOCTO #12370] The section on "Speeding Up a Build" that was in the ref-manual needed to be in the dev-manual as it is a "how-to" section. Moved it. (From yocto-docs rev: 44d2889a4f3fb5dfabb1ea4df68a1b8bbf9347c8) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/dev-manual/dev-manual-start.xml | 36 +++++++++++---------------- documentation/ref-manual/ref-variables.xml | 8 +++--- 2 files changed, 19 insertions(+), 25 deletions(-) (limited to 'documentation') diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index 21f5e9ed5e..27237c0d20 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml @@ -8,10 +8,8 @@ This chapter provides procedures related to getting set up to use the - Yocto Project. - For a more front-to-end process that takes you from minimally preparing - a build host through building an image, see the - Yocto Project Quick Start. + Yocto Project, working with Yocto Project source files, and building + an image.
@@ -857,7 +855,7 @@ information: - BB_NUMBER_THREADS: + BB_NUMBER_THREADS: The maximum number of threads BitBake simultaneously executes. @@ -865,18 +863,18 @@ The number of threads BitBake uses during parsing. - PARALLEL_MAKE: + PARALLEL_MAKE: Extra options passed to the make command during the - do_compile + do_compile task in order to specify parallel compilation on the local build host. - PARALLEL_MAKEINST: + PARALLEL_MAKEINST: Extra options passed to the make command during the - do_install + do_install task in order to specify parallel installation on the local build host. @@ -923,7 +921,7 @@ Using tmpfs for - TMPDIR + TMPDIR as a temporary file system: While this can help speed up the build, the benefits are limited due to the compiler using @@ -932,23 +930,24 @@ sync() calls into the file system on the principle that if there was a significant failure, the - Build Directory + Build Directory contents could easily be rebuilt. Inheriting the - rm_work + rm_work class: Inheriting this class has shown to speed up builds due to significantly lower amounts of data stored in the data cache as well as on disk. Inheriting this class also makes cleanup of - TMPDIR + TMPDIR faster, at the expense of being easily able to dive into the source code. File system maintainers have recommended that the fastest way to clean up large numbers of files is to reformat partitions - rather than delete files due to the linear nature of partitions. + rather than delete files due to the linear nature of + partitions. This, of course, assumes you structure the disk partitions and file systems in a way that this is practical. @@ -958,7 +957,7 @@ Remove items from - DISTRO_FEATURES + DISTRO_FEATURES that you might not need. @@ -967,7 +966,7 @@ disabling the *-dbg package generation can speed up the build. You can disable this generation by setting the - INHIBIT_PACKAGE_DEBUG_SPLIT + INHIBIT_PACKAGE_DEBUG_SPLIT variable to "1". @@ -1000,11 +999,6 @@
- - - - -