Add a warning about the order of plist helpers/keywords.

Submitted by:	dbaio
Sponsored by:	Absolight
Differential Revision:	https://reviews.freebsd.org/D16598
This commit is contained in:
Mathieu Arnold 2018-08-13 11:40:30 +00:00
parent 309860143c
commit 56fb796030
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=52123

View file

@ -382,6 +382,18 @@ PLIST_SUB= PERL_ARCH=mach</programlisting>
<programlisting>@sample(,games,660) etc/config.sample</programlisting> <programlisting>@sample(,games,660) etc/config.sample</programlisting>
<warning>
<para>If a keyword is used on an <link
linkend="makefile-options">optional</link> entry, it must to
be added after the helper:</para>
<programlisting>%%FOO%%@sample etc/orbit.conf.sample</programlisting>
<para>This is because the options plist helpers are used to
comment out the line, so they need to be put first. See <xref
linkend="options_sub"/> for more information.</para>
</warning>
<!-- <!--
Keywords up-to-date with r381632. Keywords up-to-date with r381632.
Try and keep the keywords alphanumerically sorted. Try and keep the keywords alphanumerically sorted.