From e98fd584db03fe315fa57145c699bbd874956527 Mon Sep 17 00:00:00 2001
From: Mathieu Arnold <mat@FreeBSD.org>
Date: Tue, 30 May 2017 16:35:25 +0000
Subject: [PATCH] Add the BROKEN/IGNORE/DEPRECATED block.

Sponsored by:	Absolight
---
 .../porting-samplem/chapter.xml               | 72 +++++++++++++++++++
 1 file changed, 72 insertions(+)

diff --git a/en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml
index 152016c241..a09940dc6f 100644
--- a/en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/porting-samplem/chapter.xml
@@ -343,6 +343,78 @@ pre-install:
 	variables by license name.</para>
     </sect2>
 
+    <sect2 xml:id="porting-samplem-broken">
+      <title>Generic
+	<varname>BROKEN</varname>/<varname>IGNORE</varname>/<varname>DEPRECATED</varname>
+	Messages</title>
+
+      <para>This block is optional.  The variables are:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para><link
+	      linkend="dads-deprecated">DEPRECATED</link></para>
+	</listitem>
+
+	<listitem>
+	  <para><link
+	      linkend="dads-deprecated">EXPIRATION_DATE</link></para>
+	</listitem>
+
+	<listitem>
+	  <para><link linkend="dads-noinstall">FORBIDDEN</link></para>
+	</listitem>
+
+	<listitem>
+	  <para><link linkend="dads-noinstall">BROKEN</link></para>
+	</listitem>
+
+	<listitem>
+	  <para><link linkend="dads-noinstall">BROKEN_<replaceable>*</replaceable></link></para>
+	</listitem>
+
+	<listitem>
+	  <para><link linkend="dads-noinstall">IGNORE</link></para>
+	</listitem>
+
+	<listitem>
+	  <para><link linkend="dads-noinstall">IGNORE_<replaceable>*</replaceable></link></para>
+	</listitem>
+
+	<listitem>
+	  <para><link linkend="dads-noinstall">ONLY_FOR_ARCHS</link></para>
+	</listitem>
+
+	<listitem>
+	  <para><link linkend="dads-noinstall">ONLY_FOR_ARCHS_REASON<replaceable>*</replaceable></link></para>
+	</listitem>
+
+	<listitem>
+	  <para><link linkend="dads-noinstall">NOT_FOR_ARCHS</link></para>
+	</listitem>
+
+	<listitem>
+	  <para><link linkend="dads-noinstall">NOT_FOR_ARCHS_REASON<replaceable>*</replaceable></link></para>
+	</listitem>
+      </itemizedlist>
+
+      <note>
+	<para><varname>BROKEN<replaceable>*</replaceable></varname>
+	  and <varname>IGNORE<replaceable>*</replaceable></varname>
+	  can be any generic variables, for example,
+	  <varname>IGNORE_amd64</varname>,
+	  <varname>BROKEN_FreeBSD_10</varname>,
+	  <varname>BROKEN_SSL</varname>, etc.</para>
+
+	<para>If the port is marked BROKEN when some conditions are
+	  met, and such conditions can only be tested after including
+	  <filename>bsd.port.options.mk</filename> or
+	  <filename>bsd.port.pre.mk</filename>, then those variables
+	  should be set later, in <xref
+	    linkend="porting-samplem-rest"/>.</para>
+      </note>
+    </sect2>
+
     <sect2 xml:id="porting-samplem-depends">
       <title>The Dependencies Block</title>