Date: Thu, 27 Feb 2014 18:32:13 +0000 (UTC) From: Mathieu Arnold <mat@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44089 - head/en_US.ISO8859-1/books/porters-handbook/makefiles Message-ID: <201402271832.s1RIWDDL006318@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: mat (ports committer) Date: Thu Feb 27 18:32:12 2014 New Revision: 44089 URL: http://svnweb.freebsd.org/changeset/doc/44089 Log: Split up the Options Helpers section into subsections. 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 Thu Feb 27 18:05:03 2014 (r44088) +++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Thu Feb 27 18:32:12 2014 (r44089) @@ -3630,6 +3630,9 @@ CONFIGURE_ARGS+= --disable-foo <para>There are some macros to help simplify conditional values which differ based on the options set.</para> + <sect3> + <title>OPTIONS_SUB</title> + <para>If <varname>OPTIONS_SUB</varname> is set to <literal>yes</literal> then each of the options added to <varname>OPTIONS_DEFINE</varname> will be added to @@ -3649,6 +3652,10 @@ PLIST_SUB+= OPT1="" NO_OPT1="@comment " .else PLIST_SUB+= OPT1="@comment " NO_OPT1="" .endif</programlisting> + </sect3> + + <sect3> + <title>X_CONFIGURE_ENABLE</title> <para>If <varname>X_CONFIGURE_ENABLE</varname> is set then <literal>--enable-${X_CONFIGURE_ENABLE}</literal> or @@ -3670,6 +3677,10 @@ CONFIGURE_ARGS+= --enable-test .else CONFIGURE_ARGS+= --disable-test .endif</programlisting> + </sect3> + + <sect3> + <title>X_CONFIGURE_WITH</title> <para>If <varname>X_CONFIGURE_WITH</varname> is set then <literal>--with-${X_CONFIGURE_WITH}</literal> or @@ -3691,6 +3702,10 @@ CONFIGURE_ARGS+= --with-test .else CONFIGURE_ARGS+= --without-test .endif</programlisting> + </sect3> + + <sect3> + <title>X_CONFIGURE_ON</title> <para>If <varname>X_CONFIGURE_ON</varname> is set then its value will be appended to <varname>CONFIGURE_ARGS</varname> @@ -3709,6 +3724,10 @@ OPT1_CONFIGURE_ON= --add-test</programli .if ${PORT_OPTIONS:MOPT1} CONFIGURE_ARGS+= --add-test .endif</programlisting> + </sect3> + + <sect3> + <title>X_CONFIGURE_OFF</title> <para>If <varname>X_CONFIGURE_OFF</varname> is set then its value will be appended to <varname>CONFIGURE_ARGS</varname> @@ -3727,6 +3746,10 @@ OPT1_CONFIGURE_OFF= --no-test</programli .if ! ${PORT_OPTIONS:MOPT1} CONFIGURE_ARGS+= --no-test .endif</programlisting> + </sect3> + + <sect3> + <title>X_CMAKE_ON</title> <para>If <varname>X_CMAKE_ON</varname> is set then its value will be appended to <varname>CMAKE_ARGS</varname> depending on @@ -3745,6 +3768,10 @@ OPT1_CMAKE_ON= -DTEST:BOOL=true</program .if ${PORT_OPTIONS:MOPT1} CMAKE_ARGS+= -DTEST:BOOL=true .endif</programlisting> + </sect3> + + <sect3> + <title>X_CMAKE_OFF</title> <para>If <varname>X_CMAKE_OFF</varname> is set then its value will be appended to <varname>CMAKE_ARGS</varname> depending on @@ -3763,6 +3790,10 @@ OPT1_CMAKE_OFF= -DTEST:BOOL=false</progr .if ! ${PORT_OPTIONS:MOPT1} CMAKE_ARGS+= -DTEST:BOOL=false .endif</programlisting> + </sect3> + + <sect3> + <title>Generic Variables Replacement</title> <para>For any of the following variables:</para> @@ -3840,6 +3871,9 @@ CMAKE_ARGS+= -DTEST:BOOL=false </listitem> </itemizedlist> + <sect4> + <title>X_ABOVEVARIABLE</title> + <para>If <varname>X_ABOVEVARIABLE</varname> is defined then its value will be appended to <varname>ABOVEVARIABLE</varname> depending on the status of @@ -3859,6 +3893,10 @@ OPT1_CFLAGS= -DTEST</programlisting> USES+= gmake CFLAGS+= -DTEST .endif</programlisting> + </sect4> + + <sect4> + <title>X_ABOVEVARIABLE_OFF</title> <para>If <varname>X_ABOVEVARIABLE_OFF</varname> is set then a flag <literal>ABOVEVARIABLE</literal> will be automatically @@ -3878,6 +3916,12 @@ OPT1_USES_OFF=gmake</programlisting> USES+= gmake .endif</programlisting> + </sect4> + </sect3> + + <sect3> + <title>Dependencies</title> + <para>For any of the following dependency type:</para> <itemizedlist> @@ -3910,6 +3954,9 @@ USES+= gmake </listitem> </itemizedlist> + <sect4> + <title>X_ABOVEVARIABLE</title> + <para>If <varname>X_ABOVEVARIABLE</varname> is defined then its value will be appended to <varname>ABOVEVARIABLE</varname> depending on the status @@ -3928,6 +3975,11 @@ OPT1_LIB_DEPENDS= liba.so:${PORTSDIR}/de LIB_DEPENDS+= liba.so:${PORTSDIR}/devel/a .endif</programlisting> + </sect4> + + <sect4> + <title>X_ABOVEVARIABLE_OFF</title> + <para>If <varname>X_ABOVEVARIABLE_OFF</varname> is set then a dependency of type <literal>ABOVEVARIABLE</literal> will be added when option <literal>X</literal> is not selected. For @@ -3945,6 +3997,8 @@ OPT1_LIB_DEPENDS_OFF= liba.so:${PORTSDIR . if ! ${PORT_OPTIONS:MOPT1} LIB_DEPENDS+= liba.so:${PORTSDIR}/devel/a .endif</programlisting> + </sect4> + </sect3> </sect2> </sect1>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201402271832.s1RIWDDL006318>