From patchwork Sat Jan 16 22:37:22 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Yann E. MORIN" X-Patchwork-Id: 569113 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from whitealder.osuosl.org (smtp1.osuosl.org [140.211.166.138]) by ozlabs.org (Postfix) with ESMTP id 14E2C14031D for ; Sun, 17 Jan 2016 09:40:37 +1100 (AEDT) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b=qWD/eV1M; dkim-atps=neutral Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id 5EB6391C37; Sat, 16 Jan 2016 22:40:35 +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 C5MgXOxrQ+gM; Sat, 16 Jan 2016 22:40:31 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by whitealder.osuosl.org (Postfix) with ESMTP id 8F8298C4C1; Sat, 16 Jan 2016 22:39:11 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from hemlock.osuosl.org (smtp2.osuosl.org [140.211.166.133]) by ash.osuosl.org (Postfix) with ESMTP id BD5591C0866 for ; Sat, 16 Jan 2016 22:39:05 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by hemlock.osuosl.org (Postfix) with ESMTP id B93818B0C2 for ; Sat, 16 Jan 2016 22:39:05 +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 OLYIh4fd5cOo for ; Sat, 16 Jan 2016 22:39:05 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-wm0-f68.google.com (mail-wm0-f68.google.com [74.125.82.68]) by hemlock.osuosl.org (Postfix) with ESMTPS id 105AE8948E for ; Sat, 16 Jan 2016 22:39:05 +0000 (UTC) Received: by mail-wm0-f68.google.com with SMTP id b14so9353000wmb.1 for ; Sat, 16 Jan 2016 14:39:04 -0800 (PST) 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=xGmv0liH/FvmN8ETsNeVaYquK76B31m+32RS/DvhSa0=; b=qWD/eV1MEaB9MzKa71Jo+TSq09I3eIHYuWFmHZ0Jg32lg4WgRwZc8MPJmDfSAsmYTD MqDnyerkZ65M2zsuKxeXfIY0bzlxWFJ/m1tsT0ryPkdsuGDhfii9VvO48Htjweu4/CT8 dxAxw9uFAZVvn3/q2/HK/tIcp5Im8LoYUXn1hENgmcvkk+8uxgG6GzkUuIymInZidrxa nP6kpNYTvLryKl/dY5o1z/KRJkM74nHyBstsR6Qv9nsEVFPtmvKY+FBSjTzy+jPe1pCq RQl7HQcPPG1tUSdfXs8PTdTmyeBNbtY7QTnqNhUWk3MAo+NH3Rj7OJjg4PgNE66t3zQE Ko6w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references; bh=xGmv0liH/FvmN8ETsNeVaYquK76B31m+32RS/DvhSa0=; b=Mq/jRU7MXIM7DCRMZO4KCK8FxCO3KQMPp+8m5XQorY+3h12u355eUxdmZaSHsE6Vdc YTcNR4OBFEnteRlYq1fYR6VimP2HwGhI4/vOH5QOELGthDEC10QhmFxwIzPbLKgDKg9E EIb+jOKgMsFqdOizz07rHxOxNYgofG6CXmeg4HfHyKA5lwKxxbJN5ID5aaCDE1JuATXO AUXlCr//ld7Wge3jJQuN5Qkv4npMra0dm0yNhVUR3lfLMZpiQlKZ9fcJb676cIs7RKfU D9VQKQmaONHF0EkcHI8Sttrm3QbhibAZuuH2rWE9cW2Yci85DHG1WCUihz1gfJy2sMDg 0s1A== X-Gm-Message-State: ALoCoQk+Vz1cw9wEKFgCsNx0EKZ2iwFvdb8aoCuy49nmavAFCUYMcSUyudFQt1ft/ABwYeTK1nIiKraLGADmThdrUtsekGwfjw== X-Received: by 10.194.175.170 with SMTP id cb10mr19805127wjc.36.1452983943792; Sat, 16 Jan 2016 14:39:03 -0800 (PST) Received: from gourin.bzh.lan (ns304657.ip-46-105-103.eu. [46.105.103.66]) by smtp.gmail.com with ESMTPSA id ei9sm16754384wjd.40.2016.01.16.14.39.02 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Sat, 16 Jan 2016 14:39:03 -0800 (PST) From: "Yann E. MORIN" To: buildroot@buildroot.org Date: Sat, 16 Jan 2016 23:37:22 +0100 Message-Id: <788d2ea458c8ba66e8d16d9634629cce1284533c.1452983019.git.yann.morin.1998@free.fr> X-Mailer: git-send-email 1.9.1 In-Reply-To: References: Cc: "Yann E. MORIN" Subject: [Buildroot] [PATCH 30/80 v1] docs/manual: add example about sub-options X-BeenThere: buildroot@busybox.net X-Mailman-Version: 2.1.18-1 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" Signed-off-by: "Yann E. MORIN" --- Changes RFC -> v1: - wrap example at 72-chars (Arnout) --- docs/manual/adding-packages-directory.txt | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/docs/manual/adding-packages-directory.txt b/docs/manual/adding-packages-directory.txt index b9596a2..9df8d25 100644 --- a/docs/manual/adding-packages-directory.txt +++ b/docs/manual/adding-packages-directory.txt @@ -54,6 +54,31 @@ examples in other packages. The syntax of the +Config.in+ file is the same as the one for the kernel Kconfig file. The documentation for this syntax is available at http://kernel.org/doc/Documentation/kbuild/kconfig-language.txt[] +For example: + +--------------------------- +config BR2_PACKAGE_LIBFOO + bool "libfoo" + help + This is a comment that explains what libfoo is. + + http://foosoftware.org/libfoo/ + +if BR2_PACKAGE_LIBFOO + +config BR2_PACKAGE_LIBFOO_BAR + bool "bar support" + help + This is a comment that briefly explains what bar support is, + if it's not obvious. + +endif # BR2_PACKAGE_LIBFOO +--------------------------- + +The sub-options will be cleanly indented below the main symbol when it +is enabled, and will be properly hidden when the symbol is disabled. + + Finally you have to add your new +libfoo/Config.in+ to +package/Config.in+ (or in a category subdirectory if you decided to put your package in one of the existing categories). The files