From owner-svn-doc-all@FreeBSD.ORG  Mon Dec 10 11:23:33 2012
Return-Path: <owner-svn-doc-all@FreeBSD.ORG>
Delivered-To: svn-doc-all@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
 by hub.freebsd.org (Postfix) with ESMTP id 11A89D64;
 Mon, 10 Dec 2012 11:23:33 +0000 (UTC)
 (envelope-from zeising@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org
 [IPv6:2001:1900:2254:2068::e6a:0])
 by mx1.freebsd.org (Postfix) with ESMTP id D04EA8FC0C;
 Mon, 10 Dec 2012 11:23:32 +0000 (UTC)
Received: from svn.freebsd.org (localhost [127.0.0.1])
 by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id qBABNWE6098969;
 Mon, 10 Dec 2012 11:23:32 GMT (envelope-from zeising@svn.freebsd.org)
Received: (from zeising@localhost)
 by svn.freebsd.org (8.14.5/8.14.5/Submit) id qBABNWZo098968;
 Mon, 10 Dec 2012 11:23:32 GMT (envelope-from zeising@svn.freebsd.org)
Message-Id: <201212101123.qBABNWZo098968@svn.freebsd.org>
From: Niclas Zeising <zeising@FreeBSD.org>
Date: Mon, 10 Dec 2012 11:23:32 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
 svn-doc-head@freebsd.org
Subject: svn commit: r40316 - head/en_US.ISO8859-1/books/porters-handbook
X-SVN-Group: doc-head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-doc-all@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: "SVN commit messages for the entire doc trees \(except for &quot;
 user&quot; , &quot; projects&quot; , and &quot; translations&quot;
 \)" <svn-doc-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all>
List-Post: <mailto:svn-doc-all@freebsd.org>
List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 10 Dec 2012 11:23:33 -0000

Author: zeising
Date: Mon Dec 10 11:23:32 2012
New Revision: 40316
URL: http://svnweb.freebsd.org/changeset/doc/40316

Log:
  Add documentation about the newly added OPTIONS knobs.
  
  Submitted by:	bapt
  Approved by:	joel (mentor)

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/book.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/book.xml	Mon Dec 10 02:11:24 2012	(r40315)
+++ head/en_US.ISO8859-1/books/porters-handbook/book.xml	Mon Dec 10 11:23:32 2012	(r40316)
@@ -4427,6 +4427,13 @@ OPT6_DESC=	Describe OPT6</programlisting
 	  <programlisting>OPTIONS_SINGLE=		SG1
 OPTIONS_SINGLE_SG1=	OPT3 OPT4</programlisting>
 
+	  <para><makevar>OPTIONS</makevar> can be grouped as radio
+	    choices, where none or only one choice from each group
+	    is allowed:</para>
+
+	<programlisting>OPTIONS_RADIO=		RG1
+OPTIONS_RADIO_RG1=	OPT7 OPT8</programlisting>
+
 	  <para><makevar>OPTIONS</makevar> can also be grouped as
 	    <quote>multiple-choice</quote> lists, where
 	    <emphasis>at least one</emphasis> option must be
@@ -4435,20 +4442,12 @@ OPTIONS_SINGLE_SG1=	OPT3 OPT4</programli
 	  <programlisting>OPTIONS_MULTI=		MG1
 OPTIONS_MULTI_MG1=	OPT5 OPT6</programlisting>
 
-	  <para><makevar>OPTIONS_MULTI</makevar> and
-	    <makevar>OPTIONS_SINGLE</makevar> can also allow zero
-	    choices by including the group in
-	    <makevar>OPTIONS_DEFINE</makevar>:</para>
-
-	  <programlisting>OPTIONS_DEFINE=		MG1
-OPTIONS_MULTI=		MG1
-OPTIONS_MULTI_MG1=	OPT5 OPT6</programlisting>
+	  <para><makevar>OPTIONS</makevar> can also be grouped as
+	    <quote>multiple-choice</quote> lists, where non or any
+	    option can be enabled:</para>
 
-	  <para>This group then requires at least one
-	    <makevar>OPTION</makevar> from <makevar>MG1</makevar>
-	    only if the new <makevar>MG1</makevar>
-	    <makevar>OPTION</makevar> is selected.  Experimentation
-	    is encouraged to ensure that this is understood.</para>
+	  <programlisting>OPTIONS_GROUP=		GG1
+OPTIONS_GROUP_GG1=	OPT9 OPT10</programlisting>
 
 	  <para><makevar>OPTIONS</makevar> are unset by default,
 	    unless they are listed in