From owner-freebsd-ports-bugs@FreeBSD.ORG Tue Jul 30 17:10:00 2013 Return-Path: Delivered-To: freebsd-ports-bugs@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id B5ABC114 for ; Tue, 30 Jul 2013 17:10:00 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 8E9B12FEA; Tue, 30 Jul 2013 17:10:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id r6UHA07n034065; Tue, 30 Jul 2013 17:10:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id r6UHA02D034064; Tue, 30 Jul 2013 17:10:00 GMT (envelope-from gnats) Resent-Date: Tue, 30 Jul 2013 17:10:00 GMT Resent-Message-Id: <201307301710.r6UHA02D034064@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-ports-bugs@FreeBSD.org Resent-Cc: bapt@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Mathieu Arnold Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 8CDF7FB0 for ; Tue, 30 Jul 2013 16:59:55 +0000 (UTC) (envelope-from mat@aragorn.in.absolight.net) Received: from prod2.absolight.net (mx3.absolight.net [IPv6:2a01:678:2:100::25]) (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 50CFA2F9C for ; Tue, 30 Jul 2013 16:59:53 +0000 (UTC) Received: from prod2.absolight.net (localhost [127.0.0.1]) by prod2.absolight.net (Postfix) with ESMTP id 7E56FBDC61 for ; Tue, 30 Jul 2013 18:59:52 +0200 (CEST) Received: from gw.in.absolight.net (unknown [79.143.241.69]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (Client CN "gw.in.absolight.net", Issuer "CA Cert Signing Authority" (not verified)) by prod2.absolight.net (Postfix) with ESMTPSA id 3BF5ABDC5E for ; Tue, 30 Jul 2013 18:59:52 +0200 (CEST) Received: from aragorn.in.absolight.net (aragorn.in.absolight.net [79.143.241.225]) by gw.in.absolight.net (Postfix) with ESMTP id 5C2EF6120 for ; Tue, 30 Jul 2013 18:59:51 +0200 (CEST) Received: by aragorn.in.absolight.net (Postfix, from userid 1000) id CDE7F14269C; Tue, 30 Jul 2013 18:59:50 +0200 (CEST) Message-Id: <20130730165950.CDE7F14269C@aragorn.in.absolight.net> Date: Tue, 30 Jul 2013 18:59:50 +0200 (CEST) From: Mathieu Arnold To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 X-GNATS-Notify: bapt@FreeBSD.org Subject: ports/180949: Add some documentation to bsd.options.mk knobs. X-BeenThere: freebsd-ports-bugs@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: Mathieu Arnold List-Id: Ports bug reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Jul 2013 17:10:00 -0000 >Number: 180949 >Category: ports >Synopsis: Add some documentation to bsd.options.mk knobs. >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-ports-bugs >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Jul 30 17:10:00 UTC 2013 >Closed-Date: >Last-Modified: >Originator: Mathieu Arnold >Release: FreeBSD 9.1-RELEASE-p4 i386 >Organization: Absolight >Environment: System: FreeBSD aragorn.in.absolight.net 9.1-RELEASE-p4 FreeBSD 9.1-RELEASE-p4 #0: Mon Jun 17 11:38:17 UTC 2013 root@amd64-builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC i386 >Description: >How-To-Repeat: >Fix: Fill tree to change the wording :-) --- doc begins here --- Index: Mk/bsd.options.mk =================================================================== --- Mk/bsd.options.mk (revision 323975) +++ Mk/bsd.options.mk (working copy) @@ -68,6 +68,31 @@ # # WITH - Set options from the command line # WITHOUT - Unset options from the command line +# +# +# The following knobs are there to simplfy the handling of OPTIONS in simple +# cases : +# +# OPTIONS_SUB When defined it will add to PLIST_SUB: Option +# enabled ${opt}="" Option disabled ${opt}="@comment " +# +# ${opt}_CONFIGURE_ON When option is enabled, it will add its content to +# the CONFIGURE_ARGS. ${opt}_CONFIGURE_OFF When option is disabled, it +# will add its content to the CONFIGURE_ARGS. ${opt}_CONFIGURE_ENABLE Will +# add to CONFIGURE_ARGS: Option enabled --enable-${content} Option disabled +# --disable-${content} +# +# ${opt}_CMAKE_ON When option is enabled, it will add its content to +# the CMAKE_ARGS. ${opt}_CMAKE_OFF When option is disabled, it will +# add its content to the CMAKE_ARGS. +# +# For each of CFLAGS CXXFLAGS LDFLAGS CONFIGURE_ENV MAKE_ENV USES DISTFILES, +# defining ${opt}_${variable} will add it to the actual variable when the +# option is enabled. +# +# For each of the depends target PKG EXTRACT PATCH FETCH BUILD LIB RUN, +# defining ${opt}_${deptype}_DEPENDS will add it to the actual dependency when +# the option is enabled. ## # Set all the options available for the ports, beginning with the --- doc ends here --- >Release-Note: >Audit-Trail: >Unformatted: