diff --git a/en_US.ISO8859-1/books/porters-handbook/book.xml b/en_US.ISO8859-1/books/porters-handbook/book.xml
index 95c13fbd5d..8ac53488dc 100644
--- a/en_US.ISO8859-1/books/porters-handbook/book.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/book.xml
@@ -4856,6 +4856,24 @@ OPT1_CFLAGS=	-DTEST</programlisting>
 .if ${PORT_OPTIONS:MOPT1}
 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 &lt;bsd.port.options.mk&gt;
+
+.if ! ${PORT_OPTIONS:MOPT1}
+USES+=	gmake
 .endif</programlisting>
 
 	<para>For any of the following dependency type:</para>
@@ -4906,6 +4924,24 @@ OPT1_LIB_DEPENDS=	liba.so:${PORTSDIR}/devel/a</programlisting>
 
 .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 &lt;bsd.port.options.mk&gt;
+
+. if ! ${PORT_OPTIONS:MOPT1}
+LIB_DEPENDS+=	liba.so:${PORTSDIR}/devel/a 
 .endif</programlisting>
       </sect2>
     </sect1>