Date: Tue, 30 Jul 2013 18:59:50 +0200 (CEST) From: Mathieu Arnold <mat@FreeBSD.org> To: FreeBSD-gnats-submit@freebsd.org Subject: ports/180949: Add some documentation to bsd.options.mk knobs. Message-ID: <20130730165950.CDE7F14269C@aragorn.in.absolight.net> Resent-Message-ID: <201307301710.r6UHA02D034064@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20130730165950.CDE7F14269C>