From ef1c70059fc1163c7a0f7331184efee3050a3025 Mon Sep 17 00:00:00 2001
From: Mathieu Arnold <mat@FreeBSD.org>
Date: Fri, 24 Nov 2017 18:44:00 +0000
Subject: [PATCH] Make a note of BROKEN_SSL* variables.

Sponsored by:	Absolight
---
 .../books/porters-handbook/uses/chapter.xml            | 10 ++++++++++
 1 file changed, 10 insertions(+)

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">