From crees@FreeBSD.org  Mon Jun  4 16:07:53 2012
Return-Path: <crees@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 3F6EF1065670
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  4 Jun 2012 16:07:53 +0000 (UTC)
	(envelope-from crees@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id 2A6D58FC15
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  4 Jun 2012 16:07:53 +0000 (UTC)
Received: from freefall.freebsd.org (localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q54G7qDD097111
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 4 Jun 2012 16:07:53 GMT
	(envelope-from crees@freefall.freebsd.org)
Received: (from crees@localhost)
	by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q54G7qr6097110;
	Mon, 4 Jun 2012 16:07:52 GMT
	(envelope-from crees)
Message-Id: <201206041607.q54G7qr6097110@freefall.freebsd.org>
Date: Mon, 4 Jun 2012 16:07:52 GMT
From: Chris Rees <utisoft@gmail.com>
Reply-To: Chris Rees <crees@freebsd.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] Porter's Handbook: update optionsng
X-Send-Pr-Version: 3.113
X-GNATS-Notify: bryan@shatow.net

>Number:         168675
>Category:       docs
>Synopsis:       [PATCH] Porter's Handbook: update optionsng
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    eadler
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jun 04 16:10:10 UTC 2012
>Closed-Date:    Wed Jun 13 03:08:35 UTC 2012
>Last-Modified:  Wed Jun 13 03:08:35 UTC 2012
>Originator:     Chris Rees
>Release:        FreeBSD 9.0-STABLE i386
>Organization:
>Environment:
System: FreeBSD freefall.freebsd.org 9.0-STABLE FreeBSD 9.0-STABLE #6 r235139: Tue May 8 21:19:03 UTC 2012 simon@freefall.freebsd.org:/usr/obj/usr/src/sys/FREEFALL i386


	
>Description:
The latest OPTIONSng documentation patch as requested by Bryan Drewery.

This shows that one can make a single/multi group of options allow zero selections-- normally a minimum of one in total is required.

http://www.bayofrum.net/~crees/rendered/makefile-options.html

>How-To-Repeat:
	
>Fix:

	

--- porters-document-optional-group.diff begins here ---
Index: book.sgml
===================================================================
--- book.sgml	(revision 38970)
+++ book.sgml	(working copy)
@@ -4286,6 +4286,21 @@
 	  <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>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>
+
 	  <para><makevar>OPTIONS</makevar> are unset by default,
 	    unless they are listed in
 	    <makevar>OPTIONS_DEFAULT</makevar>:</para>
--- porters-document-optional-group.diff ends here ---


>Release-Note:
>Audit-Trail:

From: Bryan Drewery <bryan@shatow.net>
To: bug-followup@FreeBSD.org, crees@freebsd.org
Cc:  
Subject: Re: docs/168675: [PATCH] Porter&#39;s Handbook: update optionsng
Date: Mon, 04 Jun 2012 12:52:59 -0500

 This is an OpenPGP/MIME signed message (RFC 2440 and 3156)
 --------------enig08689FE67BEEB2FE81331D50
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: quoted-printable
 
 Sounds good to me
 
 
 --------------enig08689FE67BEEB2FE81331D50
 Content-Type: application/pgp-signature; name="signature.asc"
 Content-Description: OpenPGP digital signature
 Content-Disposition: attachment; filename="signature.asc"
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.9 (MingW32)
 Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
 
 iQIcBAEBAgAGBQJPzPX/AAoJEG54KsA8mwz5C4QQAIkVSjb5R47y62UnssOkE3cH
 vA3R47VhzxAagya4at8zxxLbde7c37ckBAdKz9yud4dXGa9L99kJbhYj5ZwSR8t/
 s+cj0JEcD5YoobkyVss30APfVDmgPQv4I71RwiT+jKk9zbGg0Z9q3ViwcR3KykK3
 Mn3lRoQgOb7d9IeMFgWP+q5aYplQ/z+eIB4DPVXlgEpxAQpxuUwhBXlzWUsoDKpY
 i+u8JUgcyjGpRLeQg+CTv9BLpI+WQLBU3oeHNI1KxPqFq88h6fct7HHiV0V6Wzrp
 pWgOqQfjRPdx1mUvA3HLkSXrIJYbGJwPAK9qci/G/nryt7BB5sjhyAIx/FHKsLwT
 vz1FmuNw/Bxh+UxrXs4NF4ZdPUD6MVTy5C+upFkHzJdaJ7QGT8zn50x7rrTSAj4w
 S/+3npGKjLuWJ5AkKl4zQ5QOwH7EfAED7YF+d/NIN4py9Fne2LubljcKKQmsr7C2
 6sNf909lbSGDLTQqrPnjNGUQnGpnx7kovtzS36NJaD3mgfx8IayFVyqbyBTPFqX9
 UxWK5X2fTzxjsxk1lrivCfcc85sqh2qLo6yMmGQ+aOFXV8cwMQ+jRPECLgeMO/Bw
 42D3HKDtS7fSNHR/DZhlIWkXPV0JiIR6Wga2eCHPQObHpf+N66vMUxPcySJTfbQJ
 Wd9DtOwATaihlNDRo+7f
 =Onf7
 -----END PGP SIGNATURE-----
 
 --------------enig08689FE67BEEB2FE81331D50--
Responsible-Changed-From-To: freebsd-doc->eadler 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Tue Jun 5 05:43:03 UTC 2012 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=168675 
State-Changed-From-To: open->closed 
State-Changed-By: eadler 
State-Changed-When: Wed Jun 13 03:08:34 UTC 2012 
State-Changed-Why:  
Committed. Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=168675 
>Unformatted:
