From patchwork Tue Apr 17 14:45:20 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Petazzoni X-Patchwork-Id: 153209 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from fraxinus.osuosl.org (fraxinus.osuosl.org [140.211.166.137]) by ozlabs.org (Postfix) with ESMTP id 23FC9B7023 for ; Wed, 18 Apr 2012 00:48:48 +1000 (EST) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id CAD0B10030D; Tue, 17 Apr 2012 14:48:46 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org X-Amavis-Alert: BAD HEADER SECTION, Duplicate header field: "References" Received: from fraxinus.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id GRJoDSTUP+fn; Tue, 17 Apr 2012 14:48:39 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by fraxinus.osuosl.org (Postfix) with ESMTP id 5E6DA100DBD; Tue, 17 Apr 2012 14:46:43 +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 B43228F75B for ; Tue, 17 Apr 2012 14:46:26 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id A6FA28E2C0 for ; Tue, 17 Apr 2012 14:46:26 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org X-Amavis-Alert: BAD HEADER SECTION, Duplicate header field: "References" Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id XuqL8Xh58Jie for ; Tue, 17 Apr 2012 14:46:19 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail.free-electrons.com (mail.free-electrons.com [88.190.12.23]) by whitealder.osuosl.org (Postfix) with ESMTP id 64AD98E862 for ; Tue, 17 Apr 2012 14:46:09 +0000 (UTC) Received: by mail.free-electrons.com (Postfix, from userid 106) id D06C61BE; Tue, 17 Apr 2012 16:45:31 +0200 (CEST) Received: from localhost (col31-4-88-188-83-94.fbx.proxad.net [88.188.83.94]) by mail.free-electrons.com (Postfix) with ESMTPSA id F00681D2 for ; Tue, 17 Apr 2012 16:45:07 +0200 (CEST) From: Thomas Petazzoni To: buildroot@busybox.net Date: Tue, 17 Apr 2012 16:45:20 +0200 Message-Id: X-Mailer: git-send-email 1.7.4.1 In-Reply-To: References: In-Reply-To: References: Subject: [Buildroot] [PATCH 08/22] pkg-*.mk: add some comments, update some existing comments 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: Thomas Petazzoni --- package/pkg-autotargets.mk | 4 +--- package/pkg-download.mk | 9 +++++++++ package/pkg-gentargets.mk | 10 ++++------ package/pkg-utils.mk | 13 +++++++++++++ 4 files changed, 27 insertions(+), 9 deletions(-) diff --git a/package/pkg-autotargets.mk b/package/pkg-autotargets.mk index fd118dc..c9887c2 100644 --- a/package/pkg-autotargets.mk +++ b/package/pkg-autotargets.mk @@ -3,9 +3,7 @@ # # This file implements an infrastructure that eases development of # package .mk files for autotools packages. It should be used for all -# packages that use the autotools as their build system. Non-autotools -# packages should use the generic infrastructure in -# package/Makefile.package.in. +# packages that use the autotools as their build system. # # See the Buildroot documentation for details on the usage of this # infrastructure diff --git a/package/pkg-download.mk b/package/pkg-download.mk index a565ae6..ccf819e 100644 --- a/package/pkg-download.mk +++ b/package/pkg-download.mk @@ -1,3 +1,12 @@ +############################################################################ +# +# This file contains the download helpers for the various package +# infrastructures. It is used to handle downloads from HTTP servers, +# FTP servers, Git repositories, Subversion repositories, Mercurial +# repositories, Bazaar repositories, and SCP servers. +# +############################################################################ + # Download method commands WGET:=$(call qstrip,$(BR2_WGET)) $(QUIET) SVN:=$(call qstrip,$(BR2_SVN)) diff --git a/package/pkg-gentargets.mk b/package/pkg-gentargets.mk index a535681..1c9b458 100644 --- a/package/pkg-gentargets.mk +++ b/package/pkg-gentargets.mk @@ -2,9 +2,10 @@ # Generic package infrastructure # # This file implements an infrastructure that eases development of -# package .mk files. It should be used for all non-autotools based -# packages. Autotools-based packages should use the specialized -# autotools infrastructure in package/Makefile.autotools.in. +# package .mk files. It should be used for packages that do not rely +# on a well-known build system for which Buildroot has a dedicated +# infrastructure (so far, Buildroot has special support for +# autotools-based and CMake-based packages). # # See the Buildroot documentation for details on the usage of this # infrastructure @@ -17,9 +18,6 @@ # # 2. Description of the commands to be executed to configure, build # and install the package -# -# The autotools infrastructure specializes this generic infrastructure -# by already implementing the configure, build and install steps. ################################################################################ ################################################################################ diff --git a/package/pkg-utils.mk b/package/pkg-utils.mk index 729f8bb..953dbc9 100644 --- a/package/pkg-utils.mk +++ b/package/pkg-utils.mk @@ -1,3 +1,10 @@ +############################################################################ +# +# This file contains various utility functions used by the package +# infrastructure, or by the packages themselves. +# +############################################################################ + # UPPERCASE Macro -- transform its argument to uppercase and replace dots and # hyphens to underscores @@ -16,6 +23,12 @@ UPPERCASE = $(strip $(eval __tmp := $1) \ $(__tmp)))) \ $(__tmp)) +# +# Manipulation of .config files based on the Kconfig +# infrastructure. Used by the Busybox package, the Linux kernel +# package, and more. +# + define KCONFIG_ENABLE_OPT $(SED) "/\\<$(1)\\>/d" $(2) echo "$(1)=y" >> $(2)