Date: Mon, 24 Mar 2014 16:35:38 +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: r44343 - head/en_US.ISO8859-1/books/porters-handbook/makefiles Message-ID: <201403241635.s2OGZc8p081762@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: mat (ports committer) Date: Mon Mar 24 16:35:37 2014 New Revision: 44343 URL: http://svnweb.freebsd.org/changeset/doc/44343 Log: - Add a note about OPTIONS_SUB. - Add a warning about the *_TARGET options helpers. Discussed with: bjk 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 Mon Mar 24 14:36:59 2014 (r44342) +++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Mon Mar 24 16:35:37 2014 (r44343) @@ -3691,6 +3691,13 @@ PLIST_SUB+= OPT1="" NO_OPT1="@comment " .else PLIST_SUB+= OPT1="@comment " NO_OPT1="" .endif</programlisting> + + <note> + <para>The value of <varname>OPTIONS_SUB</varname> is + ignored. Setting it to any value will add + <varname>PLIST_SUB</varname> entries for + <emphasis>all</emphasis> options.</para> + </note> </sect3> <sect3 xml:id="options-configure_enable"> @@ -4027,6 +4034,36 @@ LIB_DEPENDS+= liba.so:${PORTSDIR}/devel/ </listitem> </itemizedlist> + <warning> + <para>Some of these variables, at least + <varname>ALL_TARGET</varname> and + <varname>INSTALL_TARGET</varname>, have their default + values set <emphasis>after</emphasis> the options are + processed.</para> + + <para>With the following lines in the + <filename>Makefile</filename>:</para> + + <programlisting>ALL_TARGET= all + +DOCS_ALL_TARGET= doc</programlisting> + + <para>If the <literal>DOCS</literal> option is enabled, + <varname>ALL_TARGET</varname> will have a final value of + <literal>all doc</literal>; if the option is disabled, it + would have a value of <literal>all</literal>.</para> + + <para>With only the options helper line in the + <filename>Makefile</filename>:</para> + + <programlisting>DOCS_ALL_TARGET= doc</programlisting> + + <para>If the <literal>DOCS</literal> option is enabled, + <varname>ALL_TARGET</varname> will have a final value of + <literal>doc</literal>; if the option is disabled, it + would have a value of <literal>all</literal>.</para> + </warning> + <sect4> <title><varname><replaceable>X</replaceable>_<replaceable>ABOVEVARIABLE</replaceable></varname></title>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201403241635.s2OGZc8p081762>