From patchwork Wed Aug 27 19:40:10 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas De Schampheleire X-Patchwork-Id: 383539 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from hemlock.osuosl.org (hemlock.osuosl.org [140.211.166.133]) by ozlabs.org (Postfix) with ESMTP id 3E8A0140097 for ; Thu, 28 Aug 2014 05:45:04 +1000 (EST) Received: from localhost (localhost [127.0.0.1]) by hemlock.osuosl.org (Postfix) with ESMTP id 89FA589318; Wed, 27 Aug 2014 19:45:03 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from hemlock.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id DSuXOXHCGg64; Wed, 27 Aug 2014 19:45:03 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by hemlock.osuosl.org (Postfix) with ESMTP id F288A89703; Wed, 27 Aug 2014 19:45:02 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from fraxinus.osuosl.org (fraxinus.osuosl.org [140.211.166.137]) by ash.osuosl.org (Postfix) with ESMTP id 9B2271C25A1 for ; Wed, 27 Aug 2014 19:45:01 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id 96D25A0789 for ; Wed, 27 Aug 2014 19:45:01 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from fraxinus.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id vvheG7gjHneM for ; Wed, 27 Aug 2014 19:45:00 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-we0-f169.google.com (mail-we0-f169.google.com [74.125.82.169]) by fraxinus.osuosl.org (Postfix) with ESMTPS id 12A8DA05E3 for ; Wed, 27 Aug 2014 19:44:59 +0000 (UTC) Received: by mail-we0-f169.google.com with SMTP id u56so695727wes.28 for ; Wed, 27 Aug 2014 12:44:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=content-type:mime-version:content-transfer-encoding:subject :message-id:in-reply-to:references:user-agent:date:from:to:cc; bh=QY5ouWnwxDJIknHDv8BesyDeoVs4baJ9MlMluJ13kjw=; b=fO77fzq8p5G1YcQzP1tvsVH0Z9aPyXI20Lek4Sw+M5eiW17HlDjhgpYp/LWyxVk5CN 81KpyKVC8hb6tY4eaavQh27h9cSP0BYQT3Vk1z7B0UmfzML+62vMBxzo8FIVL0nfRf+g uPkVyq+MZaw7pYPYDH/uBxZeAA1Bc/u/aQ5vm+UJc8fylFhzK2grMhNQ2d6x7Io0pJVI 57jLImS8XyVlIo8ViXpc5kuVr8ybM/lqKPOFsNF/Tpnyyy4CbOXZdkTMG5zp7ePlTOj2 s28u30y8CbtLFgECiAgKY9Jarli8wt7ppWifScLhqqFZjjoBbir68cfIxTEFMwwNccAy /XGA== X-Received: by 10.194.187.101 with SMTP id fr5mr40189993wjc.10.1409168698322; Wed, 27 Aug 2014 12:44:58 -0700 (PDT) Received: from [127.0.0.1] (d54C62EEB.access.telenet.be. [84.198.46.235]) by mx.google.com with ESMTPSA id cy10sm3565860wjb.21.2014.08.27.12.44.57 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 27 Aug 2014 12:44:57 -0700 (PDT) MIME-Version: 1.0 X-Mercurial-Node: e21c7854621143b573bf2c6410f075b26f17400b Message-Id: In-Reply-To: References: User-Agent: Mercurial-patchbomb/3.0.2 Date: Wed, 27 Aug 2014 21:40:10 +0200 From: Thomas De Schampheleire To: buildroot@buildroot.org Cc: thomas.petazzoni@free-electrons.com Subject: [Buildroot] [PATCH 1 of 2 for 2014.08] manual/user guide/customization: expand introduction text X-BeenThere: buildroot@busybox.net X-Mailman-Version: 2.1.14 Precedence: list List-Id: Discussion and development of buildroot List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: buildroot-bounces@busybox.net Sender: buildroot-bounces@busybox.net 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 --- docs/manual/customize.txt | 25 +++++++++++++++++++++---- 1 files changed, 21 insertions(+), 4 deletions(-) diff --git a/docs/manual/customize.txt b/docs/manual/customize.txt --- 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 from a clean buildroot tree. By +following the recommended strategy, you can even use the same Buildroot +tree to build multiple distinct projects! include::customize-rootfs.txt[]