From patchwork Sun Nov 11 13:14:49 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Samuel Martin X-Patchwork-Id: 198270 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from silver.osuosl.org (silver.osuosl.org [140.211.166.136]) by ozlabs.org (Postfix) with ESMTP id 72C4F2C0040 for ; Mon, 12 Nov 2012 00:16:59 +1100 (EST) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id 1435230EF6; Sun, 11 Nov 2012 13:16:58 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from silver.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id lNxQ+lmPl+nG; Sun, 11 Nov 2012 13:16:56 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by silver.osuosl.org (Postfix) with ESMTP id 761543146E; Sun, 11 Nov 2012 13:16:12 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from whitealder.osuosl.org (whitealder.osuosl.org [140.211.166.138]) by ash.osuosl.org (Postfix) with ESMTP id 8C8418F753 for ; Sun, 11 Nov 2012 13:15:41 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id 6154A8C2D7 for ; Sun, 11 Nov 2012 13:15:37 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id zQkoFRJfn3XA for ; Sun, 11 Nov 2012 13:15:36 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-we0-f171.google.com (mail-we0-f171.google.com [74.125.82.171]) by whitealder.osuosl.org (Postfix) with ESMTPS id 3C0748C2A6 for ; Sun, 11 Nov 2012 13:15:36 +0000 (UTC) Received: by mail-we0-f171.google.com with SMTP id s43so3028443wey.16 for ; Sun, 11 Nov 2012 05:15:35 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id:x-mailer:in-reply-to:references; bh=VhKnQtCW3An7EcK3OzohOHZAPL1I6hHH61izKZgABDk=; b=IJqNDzXvBH4FbBbic6g67ffFsmSGkrN4qS7mp4gOI6ZCOzyzboHNiaCXwF5I2HohLp /nQJ9sEgRUq86Ud2O962ZACGW2oStGbMTq6Wx9i2EPn76AafVg3rTDCjUQeo7+GGlNWi 0j41UVvW0xLcFNE/6rQQnd2gp6Iue9sWxQIdjnIfCma9zXzjiri8ybgc/LVRumsbYMRQ +Eu+Dxi250cbmins64v3SWaGqi5+aiHL8z+FavCqc3fEQgi6v+/VW/rW+Feau1LObNnb XHp3Q42fKX2Zhd8tHRKn2SfdGc6ejIWorhk7YeoYZmAu61xgYUDc3Y/aLlW04CEaozTi yR3w== Received: by 10.181.13.194 with SMTP id fa2mr10756129wid.10.1352639735947; Sun, 11 Nov 2012 05:15:35 -0800 (PST) Received: from localhost.localdomain (ivr94-4-82-229-165-48.fbx.proxad.net. [82.229.165.48]) by mx.google.com with ESMTPS id hv4sm10262550wib.0.2012.11.11.05.15.34 (version=SSLv3 cipher=OTHER); Sun, 11 Nov 2012 05:15:35 -0800 (PST) From: Samuel Martin To: buildroot@busybox.net Date: Sun, 11 Nov 2012 14:14:49 +0100 Message-Id: <1352639701-27829-12-git-send-email-s.martin49@gmail.com> X-Mailer: git-send-email 1.8.0 In-Reply-To: <1352639701-27829-1-git-send-email-s.martin49@gmail.com> References: <1352639701-27829-1-git-send-email-s.martin49@gmail.com> Subject: [Buildroot] [PATCH 11/23] manual: add make-tips.txt 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: , MIME-Version: 1.0 Errors-To: buildroot-bounces@busybox.net Sender: buildroot-bounces@busybox.net Signed-off-by: Samuel Martin create mode 100644 docs/manual/make-tips.txt diff --git a/docs/manual/make-tips.txt b/docs/manual/make-tips.txt new file mode 100644 index 0000000..5b00536 --- /dev/null +++ b/docs/manual/make-tips.txt @@ -0,0 +1,58 @@ +// -*- mode:doc -*- ; + +[[make-tips]] +'make' tips +----------- + +Because Buildroot is a set of Makefiles and patches, there are few +things useful to know, such as: + ++make *config+ commands offer a search tool. Read the help message in +the different frontend menu to know how to use it: + +* in _menuconfig_, search tool is called by pressing +/+; +* in _xconfig_, search tool is called by pressing +ctrl+ + +f+. + +The result of the search show the help message of the matching items. + +Display all command executed by make: + +-------------------- + $ make V=0|1 +-------------------- + +Display all available targets: + +-------------------- + $ make help +-------------------- + +Note that some settings in the +.config+ file may hide some targets: + +* +busybox-menuconfig+ depends on whether +busybox+ is enabled or not + in the +Package selection+ menu +* +linux-menuconfig+ and +linux-savedefconfig+ depend on whether + +linux+ is enabled or not +* +uclibc-menuconfig+ depends on whether the toolchain uses the + Buildroot internal toolchain backend or not +* +ctng-menuconfig+ depends on whether the toolchain uses the + crosstool-NG backend or not +* +barebox-menuconfig+ and +barebox-savedefconfig+ depend on whether + +barebox+ bootloader is enabled or not + +Delete all build products (including build directories, host, staging +and target trees, the images and the toolchain): + +-------------------- + $ make clean +-------------------- + +Delete all build products as well as the configuration: + +-------------------- + $ make distclean +-------------------- + +Note that if +ccache+ is enabled, running +make clean|distclean+ does +not empty the cache of compiler used by Buildroot. To delete it, refer +to xref:ccache[]. diff --git a/docs/manual/working-with.txt b/docs/manual/working-with.txt index 3c57504..4ea9239 100644 --- a/docs/manual/working-with.txt +++ b/docs/manual/working-with.txt @@ -6,6 +6,8 @@ Working with Buildroot This section explains how you can customize Buildroot to fit your needs. +include::make-tips.txt[] + include::customize.txt[] include::common-usage.txt[]