summaryrefslogtreecommitdiffstats
path: root/docs/manual
diff options
context:
space:
mode:
authorThomas De Schampheleire <patrickdepinguin@gmail.com>2014-08-29 21:50:39 +0200
committerPeter Korsgaard <peter@korsgaard.com>2014-08-30 09:18:27 +0200
commita194faa44d2aec31422947b98b0ebca41f36d82f (patch)
tree278dcafb7cb294e4610d0d0c9e5c7adf01bdf899 /docs/manual
parentf4905d7a3e1945d79084ca860ac88fbfedc01eaa (diff)
downloadbuildroot-a194faa44d2aec31422947b98b0ebca41f36d82f.tar.gz
buildroot-a194faa44d2aec31422947b98b0ebca41f36d82f.zip
manual/user guide/customization: expand introduction text
This patch expands the introduction text of chapter 'Project-specific customization' by listing the type of customizations that can be performed by a project. Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
Diffstat (limited to 'docs/manual')
-rw-r--r--docs/manual/customize.txt25
1 files changed, 21 insertions, 4 deletions
diff --git a/docs/manual/customize.txt b/docs/manual/customize.txt
index 8dc428d278..c876be82d7 100644
--- a/docs/manual/customize.txt
+++ b/docs/manual/customize.txt
@@ -3,11 +3,28 @@
== Project-specific customization
-The following sections describe the various way in which you can
-customize Buildroot for a given project.
+Typical actions you may need to perform for a given project are:
-For instructions on how to add new packages to Buildroot, refer to
-xref:adding-packages[]
+- configuring Buildroot (including build options and toolchain,
+ bootloader, kernel, package and filesystem image type selection)
+- configuring other components, like the Linux kernel and BusyBox
+- adding project-specific patches to some packages (using
+ +BR2_GLOBAL_PATCH_DIR+)
+- adding or overwriting files on the target filesystem (using
+ +BR2_ROOTFS_OVERLAY+)
+- modifying or deleting files on the target filesystem (using
+ +BR2_ROOTFS_POST_BUILD_SCRIPT+)
+- running arbitrary commands prior to generating the filesystem image
+ (using +BR2_ROOTFS_POST_BUILD_SCRIPT+)
+- running arbitrary commands after generating the filesystem image
+ (using +BR2_ROOTFS_POST_IMAGE_SCRIPT+)
+- adding project-specific packages
+
+This chapter describes how to make such project-specific customizations
+in Buildroot and how to store them in a way that you can build the same
+image in a reproducible way, even after running 'make clean'. By
+following the recommended strategy, you can even use the same Buildroot
+tree to build multiple distinct projects!
include::customize-rootfs.txt[]
OpenPOWER on IntegriCloud