From patchwork Wed May 14 21:11:34 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Yann E. MORIN" X-Patchwork-Id: 348976 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 67781140094 for ; Thu, 15 May 2014 07:11:54 +1000 (EST) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id 9B81BE9C5; Wed, 14 May 2014 21:11:52 +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 DbCnTHrzHwyE; Wed, 14 May 2014 21:11:50 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by fraxinus.osuosl.org (Postfix) with ESMTP id B8ED3E9AB; Wed, 14 May 2014 21:11:48 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from silver.osuosl.org (silver.osuosl.org [140.211.166.136]) by ash.osuosl.org (Postfix) with ESMTP id 159CF1C2DF2 for ; Wed, 14 May 2014 21:11:46 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id 1260632B7F for ; Wed, 14 May 2014 21:11:46 +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 q+s+8ZOqM5qk for ; Wed, 14 May 2014 21:11:42 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-wi0-f178.google.com (mail-wi0-f178.google.com [209.85.212.178]) by silver.osuosl.org (Postfix) with ESMTPS id 7FDEE32B77 for ; Wed, 14 May 2014 21:11:42 +0000 (UTC) Received: by mail-wi0-f178.google.com with SMTP id hm4so3135468wib.11 for ; Wed, 14 May 2014 14:11:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references; bh=tr7X4WFQt/ZEkZ5VsFO5qgdcbsMGb8ilKQiydJl7tNs=; b=zZ/w64QN/tPm4dumGBilws6jZhTRjfiecaLs0m6WytQq6WJJOP6UGZKBHepo7CkG50 owkRBqfgDhMAz8XnMLQegj9Ao6DKOEsXInga+Iaqew1vgiGkPxCPUfyhPrLsPUn1c/hD GDXmrROuCPRCVc9WiYDg13m3EQgwUvHLacD0PnSXVyBGysmQrHT3UhQliWjQDxVz5uZo fdJG+kZJiFMUfaCs4kfaP3reQoNeiGJUnr3EhIiD1wf2IGeP7ibgtIJMq76yGDDLpaZp QHuCwuY3tlxNuVNT/aZBzwyO6/jHKqbx1d51BXg9FWrHeB+BYRh9RQegw2perRtrd5H1 aa2A== X-Received: by 10.180.38.107 with SMTP id f11mr5222871wik.31.1400101900886; Wed, 14 May 2014 14:11:40 -0700 (PDT) Received: from gourin.bzh.lan (ks3095497.kimsufi.com. [94.23.60.27]) by mx.google.com with ESMTPSA id ej7sm29808430wib.9.2014.05.14.14.11.38 for (version=TLSv1.1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 14 May 2014 14:11:39 -0700 (PDT) From: "Yann E. MORIN" To: buildroot@buildroot.org Date: Wed, 14 May 2014 23:11:34 +0200 Message-Id: <0dad6313445d161cc75a22d89173fc43998ade64.1400101273.git.yann.morin.1998@free.fr> X-Mailer: git-send-email 1.8.3.2 In-Reply-To: References: Cc: Thomas Petazzoni , Peter Korsgaard , "Yann E. MORIN" Subject: [Buildroot] [PATCH 2/3] docs/manual: document the new FOO_PROVIDES variable 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 From: "Yann E. MORIN" Signed-off-by: "Yann E. MORIN" Cc: Thomas Petazzoni Cc: Peter Korsgaard Cc: Thomas De Schampheleire Cc: Arnout Vandecappelle Cc: Samuel Martin --- docs/manual/adding-packages-generic.txt | 3 +++ docs/manual/adding-packages-virtual.txt | 15 ++++++++++++--- 2 files changed, 15 insertions(+), 3 deletions(-) diff --git a/docs/manual/adding-packages-generic.txt b/docs/manual/adding-packages-generic.txt index f421651..d3fa45b 100644 --- a/docs/manual/adding-packages-generic.txt +++ b/docs/manual/adding-packages-generic.txt @@ -304,6 +304,9 @@ information is (assuming the package name is +libfoo+) : a similar way, +HOST_LIBFOO_DEPENDENCIES+ lists the dependencies for the current host package. +* +LIBFOO_PROVIDES+ lists all the virtual packages +libfoo+ is an + implementation of. See xref:virtual-package-tutorial[]. + * +LIBFOO_INSTALL_STAGING+ can be set to +YES+ or +NO+ (default). If set to +YES+, then the commands in the +LIBFOO_INSTALL_STAGING_CMDS+ variables are executed to install the package into the staging diff --git a/docs/manual/adding-packages-virtual.txt b/docs/manual/adding-packages-virtual.txt index 1c1116f..0cbe753 100644 --- a/docs/manual/adding-packages-virtual.txt +++ b/docs/manual/adding-packages-virtual.txt @@ -39,7 +39,7 @@ In this file, we declare two options, +BR2_PACKAGE_HAS_SOMETHING_VIRTUAL+ and +BR2_PACKAGE_PROVIDES_SOMETHING_VIRTUAL+, whose values will be used by the providers. -==== Virtual package's +*.mk+ file +==== Virtual package's +.mk+ file The +.mk+ for the virtual package should just evaluate the +virtual-package+ macro: @@ -59,8 +59,7 @@ The ability to have target and host packages is also available, with the ==== Provider's +Config.in+ file When adding a package as a provider, only the +Config.in+ file requires some -modifications. The +*.mk+ file should follow the Buildroot infrastructure with -no change at all. +modifications. The +Config.in+ file of the package 'some-provider', which provides the functionalities of 'something-virtual', should contain: @@ -84,6 +83,16 @@ On line 3, we select +BR2_PACKAGE_HAS_SOMETHING_VIRTUAL+, and on line 11, we set the value of +BR2_PACKAGE_PROVIDES_SOMETHING_VIRTUAL+ to the name of the provider, but only if it is selected. +==== Provider's +.mk+ file + +The +.mk+ file should also declare an additional variable ++SOME_PROVIDER_PROVIDES+ to contain the names of all the virtual +packages it is an implementation of: + +--------------------------- +01: SOME_PROVIDER_PROVIDES = something-virtual +--------------------------- + Of course, do not forget to add the proper build and runtime dependencies for this package!