diff --git a/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
index 48a768f468..2963779f74 100644
--- a/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
@@ -2884,6 +2884,16 @@ SHEBANG_FILES=	scripts/foobar.pl scripts/*.sh</programlisting>
 	</listitem>
       </varlistentry>
     </variablelist>
+
+    <tip>
+      <para>If a port does not build with an
+	<application>OpenSSL</application> flavor, set the
+	<varname>BROKEN_SSL</varname> variable, and possibly the
+	<varname>BROKEN_SSL_REASON_<replaceable>flavor</replaceable></varname>:</para>
+
+      <programlisting>BROKEN_SSL=	libressl
+BROKEN_SSL_REASON_libressl=	needs features only available in OpenSSL</programlisting>
+    </tip>
   </sect1>
 
   <sect1 xml:id="uses-tar">