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

[Rene Ladan]

Author: rene
Date: Tue Jan 28 19:21:14 2014
New Revision: 43682
URL: http://svnweb.freebsd.org/changeset/doc/43682

Log:
  Document two new option helpers:
  - OPT_TYPE_DEPENDS_OFF to add a TYPE_DEPENDS when OPT is off
  - OPT_FLAG_OFF=VAL to add the VAL to FLAG when OPT is off
  
  Submitted by:	mat
  Reviewed by:	mat

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	Tue Jan 28 17:38:33 2014	(r43681)
+++ head/en_US.ISO8859-1/books/porters-handbook/book.xml	Tue Jan 28 19:21:14 2014	(r43682)
@@ -4858,6 +4858,24 @@ USES+=		gmake
 CFLAGS+=	-DTEST
 .endif</programlisting>
 
+	<para>If <varname>X_ABOVEVARIABLE_OFF</varname> is set then a
+	  flag <literal>ABOVEVARIABLE</literal> will be automatically
+	  set when option <literal>X</literal> is not selected.  For
+	  example:</para>
+
+	<programlisting>OPTIONS_DEFINE=	OPT1
+OPT1_USES_OFF=gmake</programlisting>
+
+	<para>is equivalent to:</para>
+
+	<programlisting>OPTIONS_DEFINE=	OPT1
+
+.include <bsd.port.options.mk>
+
+.if ! ${PORT_OPTIONS:MOPT1}
+USES+=	gmake
+.endif</programlisting>
+
 	<para>For any of the following dependency type:</para>
 
 	<itemizedlist>
@@ -4907,6 +4925,24 @@ OPT1_LIB_DEPENDS=	liba.so:${PORTSDIR}/de
 .if ${PORT_OPTIONS:MOPT1}
 LIB_DEPENDS+=	liba.so:${PORTSDIR}/devel/a
 .endif</programlisting>
+
+	<para>If <varname>X_ABOVEVARIABLE_OFF</varname> is set then a
+	  dependency of type <literal>ABOVEVARIABLE</literal> will be
+	  added when option <literal>X</literal> is not selected.  For
+	  example:</para>
+
+	<programlisting>OPTIONS_DEFINE=	OPT1
+OPT1_LIB_DEPENDS_OFF= liba.so:${PORTSDIR}/devel/a</programlisting>
+
+	<para>is equivalent to:</para>
+
+	<programlisting>OPTIONS_DEFINE= OPT1
+
+.include <bsd.port.options.mk>
+
+. if ! ${PORT_OPTIONS:MOPT1}
+LIB_DEPENDS+=	liba.so:${PORTSDIR}/devel/a 
+.endif</programlisting>
       </sect2>
     </sect1>