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

[Mathieu Arnold]

Author: mat
Date: Tue Mar 20 10:39:21 2018
New Revision: 51509
URL: https://svnweb.freebsd.org/changeset/doc/51509

Log:
  Expand a bit on generic IGNORE/BROKEN variables.
  
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/order/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/order/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/order/chapter.xml	Tue Mar 20 08:12:50 2018	(r51508)
+++ head/en_US.ISO8859-1/books/porters-handbook/order/chapter.xml	Tue Mar 20 10:39:21 2018	(r51509)
@@ -314,12 +314,19 @@
     </itemizedlist>
 
     <note>
-      <para><varname>BROKEN<replaceable>*</replaceable></varname>
-	and <varname>IGNORE<replaceable>*</replaceable></varname>
+      <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>
+	<varname>BROKEN_FreeBSD_10</varname>, etc.  With the exception
+	of variables that depend on a <link
+	  linkend="uses"><varname>USES</varname></link>, place those
+	in <xref linkend="porting-order-uses"/>.  For instance,
+	<varname>IGNORE_WITH_PHP</varname> only works if
+	<link linkend="uses-php"><literal>USES=php</literal></link> is
+	set, and <varname>BROKEN_SSL</varname> only if <link
+	  linkend="uses-ssl"><literal>USES=ssl</literal></link> is
+	set.</para>
 
       <para>If the port is marked BROKEN when some conditions are
 	met, and such conditions can only be tested after including