svn commit: r45205 - head/en_US.ISO8859-1/books/porters-handbook/makefiles

[Mathieu Arnold]

Author: mat (ports committer)
Date: Fri Jul  4 10:35:34 2014
New Revision: 45205
URL: http://svnweb.freebsd.org/changeset/doc/45205

Log:
  Document the optional argument *_CONFIGURE_WITH can have.
  
  PH:		D341
  Reviewed by:	wblock, bcr
  Sponsored by:	Absolight

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

Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Thu Jul  3 12:53:33 2014	(r45204)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Fri Jul  4 10:35:34 2014	(r45205)
@@ -3836,22 +3836,33 @@ CONFIGURE_ARGS+=	--disable-test
 	  <literal>--without-${<replaceable>OPT</replaceable>_CONFIGURE_WITH}</literal>
 	  will be added to <varname>CONFIGURE_ARGS</varname> depending
 	  on the status of the option
-	  <literal><replaceable>OPT</replaceable></literal>, for
-	  example:</para>
-
-	<programlisting>OPTIONS_DEFINE=	OPT1
-OPT1_CONFIGURE_WITH=	test</programlisting>
+	  <literal><replaceable>OPT</replaceable></literal>.  An
+	  optional argument can be specified with an
+	  <literal>=</literal> symbol. This argument is only appended
+	  to the
+	  <literal>--with-<replaceable>opt</replaceable></literal>
+	  configure option.  For example:</para>
+
+	<programlisting>OPTIONS_DEFINE=	OPT1 OPT2
+OPT1_CONFIGURE_WITH=	test1
+OPT1_CONFIGURE_WITH=	test2=exhaustive</programlisting>
 
 	<para>is equivalent to:</para>
 
-	<programlisting>OPTIONS_DEFINE=	OPT1
+	<programlisting>OPTIONS_DEFINE=	OPT1 OPT2
 
 .include <bsd.port.options.mk>
 
 .if ${PORT_OPTIONS:MOPT1}
-CONFIGURE_ARGS+=	--with-test
+CONFIGURE_ARGS+=	--with-test1
+.else
+CONFIGURE_ARGS+=	--without-test1
+.endif
+
+.if ${PORT_OPTIONS:MOPT2}
+CONFIGURE_ARGS+=	--with-test2=exhaustive
 .else
-CONFIGURE_ARGS+=	--without-test
+CONFIGURE_ARGS+=	--without-test2
 .endif</programlisting>
       </sect3>