svn commit: r50347 - head/en_US.ISO8859-1/books/porters-handbook/makefiles

[Mathieu Arnold]

Author: mat
Date: Fri Jun  9 15:04:57 2017
New Revision: 50347
URL: https://svnweb.freebsd.org/changeset/doc/50347

Log:
  Add a section about the opt_MESON_* helpers.
  
  Sponsored by:	Absolight

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

Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Fri Jun  9 15:04:55 2017	(r50346)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Fri Jun  9 15:04:57 2017	(r50347)
@@ -5907,6 +5907,126 @@ CMAKE_ARGS+=	-DTEST:BOOL=false -DDEBUG:BOOL=false \
 	</sect4>
       </sect3>
 
+      <sect3 xml:id="options-meson-helpers">
+	<title><varname>MESON_ARGS</varname> Helpers</title>
+
+	<sect4 xml:id="options-meson_on">
+	  <title><varname><replaceable>OPT</replaceable>_MESON_ON</varname>
+	    and
+	    <varname><replaceable>OPT</replaceable>_MESON_OFF</varname></title>
+
+	  <para>When option <replaceable>OPT</replaceable> is selected,
+	    the value of
+	    <varname><replaceable>OPT</replaceable>_MESON_ON</varname>,
+	    if defined, is appended to <varname>MESON_ARGS</varname>.
+	    <varname><replaceable>OPT</replaceable>_MESON_OFF</varname>
+	    works the same way, but when <literal>OPT</literal> is
+	    <emphasis>not</emphasis> selected.  For example:</para>
+
+	  <programlisting>OPTIONS_DEFINE=	OPT1
+OPT1_MESON_ON=	-Dopt=1
+OPT1_MESON_OFF=	-Dopt=2</programlisting>
+
+	  <para>is equivalent to:</para>
+
+	  <programlisting>OPTIONS_DEFINE=	OPT1
+
+.include <bsd.port.options.mk>
+
+.if ${PORT_OPTIONS:MOPT1}
+MESON_ARGS+=	-Dopt=1
+.else
+MESON_ARGS+=	-Dopt=2
+.endif</programlisting>
+	</sect4>
+
+	<sect4 xml:id="options-meson_true">
+	  <title><varname><replaceable>OPT</replaceable>_MESON_TRUE</varname>
+	    and
+	    <varname><replaceable>OPT</replaceable>_MESON_FALSE</varname></title>
+
+	  <para>When option <replaceable>OPT</replaceable> is selected,
+	    for each <replaceable>entry</replaceable> in
+	    <varname><replaceable>OPT</replaceable>_MESON_TRUE</varname>
+	    then
+	    <literal>-D<replaceable>entry</replaceable>=true</literal>
+	    is appended to <varname>CMAKE_ARGS</varname>.  When option
+	    <replaceable>OPT</replaceable> is <emphasis>not</emphasis>
+	    selected,
+	    <literal>-D<replaceable>entry</replaceable>=false</literal>
+	    is appended to <varname>CONFIGURE_ARGS</varname>.
+	    <varname><replaceable>OPT</replaceable>_MESON_FALSE</varname>
+	    is the oposite,
+	    <literal>-D<replaceable>entry</replaceable>=false</literal>
+	    is appended to <varname>CMAKE_ARGS</varname> when the option
+	    is selected, and
+	    <literal>-D<replaceable>entry</replaceable>=true</literal>
+	    when the option is <emphasis>not</emphasis> selected.  For
+	    example:</para>
+
+	  <programlisting>OPTIONS_DEFINE=	OPT1
+OPT1_MESON_TRUE=	test debug
+OPT1_MESON_FALSE=	optimize</programlisting>
+
+	  <para>is equivalent to:</para>
+
+	  <programlisting>OPTIONS_DEFINE=	OPT1
+
+.include <bsd.port.options.mk>
+
+.if ${PORT_OPTIONS:MOPT1}
+CMAKE_ARGS+=	-Dtest=true -Ddebug=true \
+		-Doptimize=false
+.else
+CMAKE_ARGS+=	-Dtest=false -Ddebug=false \
+		-Doptimize=true
+.endif</programlisting>
+	</sect4>
+
+	<sect4 xml:id="options-meson_yes">
+	  <title><varname><replaceable>OPT</replaceable>_MESON_YES</varname>
+	    and
+	    <varname><replaceable>OPT</replaceable>_MESON_NO</varname></title>
+
+	  <para>When option <replaceable>OPT</replaceable> is selected,
+	    for each <replaceable>entry</replaceable> in
+	    <varname><replaceable>OPT</replaceable>_MESON_YES</varname>
+	    then
+	    <literal>-D<replaceable>entry</replaceable>=yes</literal>
+	    is appended to <varname>CMAKE_ARGS</varname>.  When option
+	    <replaceable>OPT</replaceable> is <emphasis>not</emphasis>
+	    selected,
+	    <literal>-D<replaceable>entry</replaceable>=no</literal>
+	    is appended to <varname>CONFIGURE_ARGS</varname>.
+	    <varname><replaceable>OPT</replaceable>_MESON_NO</varname>
+	    is the oposite,
+	    <literal>-D<replaceable>entry</replaceable>=no</literal>
+	    is appended to <varname>CMAKE_ARGS</varname> when the option
+	    is selected, and
+	    <literal>-D<replaceable>entry</replaceable>=yes</literal>
+	    when the option is <emphasis>not</emphasis> selected.  For
+	    example:</para>
+
+	  <programlisting>OPTIONS_DEFINE=	OPT1
+OPT1_MESON_YES=	test debug
+OPT1_MESON_NO=	optimize</programlisting>
+
+	  <para>is equivalent to:</para>
+
+	  <programlisting>OPTIONS_DEFINE=	OPT1
+
+.include <bsd.port.options.mk>
+
+.if ${PORT_OPTIONS:MOPT1}
+CMAKE_ARGS+=	-Dtest=yes -Ddebug=yes \
+		-Doptimize=no
+.else
+CMAKE_ARGS+=	-Dtest=no -Ddebug=no \
+		-Doptimize=yes
+.endif</programlisting>
+	</sect4>
+      </sect3>
+
       <sect3 xml:id="options-qmake_on">
 	<title><varname><replaceable>OPT</replaceable>_QMAKE_ON</varname>
 	  and