Add a variablelist with all the options helpers.
Sponsored by: Absolight
This commit is contained in:
parent
f1c1e9281a
commit
34a38b937a
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=51175
1 changed files with 128 additions and 1 deletions
|
@ -6010,7 +6010,134 @@ FOO_CONFIGURE_ENABLE= foo</programlisting>
|
|||
<title>Options Helpers</title>
|
||||
|
||||
<para>There are some macros to help simplify conditional values
|
||||
which differ based on the options set.</para>
|
||||
which differ based on the options set. For easier access, a
|
||||
list is provided in the list bellow:</para>
|
||||
|
||||
<variablelist xml:id="options-helpers-list">
|
||||
<varlistentry>
|
||||
<term><varname>PLIST_SUB</varname>,
|
||||
<varname>SUB_LIST</varname></term>
|
||||
|
||||
<listitem>
|
||||
<para>See <xref linkend="options_sub"/>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><varname>CONFIGURE_ARGS</varname></term>
|
||||
|
||||
<listitem>
|
||||
<para>For
|
||||
<literal>--enable-<replaceable>x</replaceable></literal>
|
||||
and
|
||||
<literal>--disable-<replaceable>x</replaceable></literal>,
|
||||
see <xref linkend="options-configure_enable"/>.</para>
|
||||
|
||||
<para>For
|
||||
<literal>--with-<replaceable>x</replaceable></literal>
|
||||
and
|
||||
<literal>--without-<replaceable>x</replaceable></literal>,
|
||||
see <xref linkend="options-configure_with"/>.</para>
|
||||
|
||||
<para>For all other cases, see <xref
|
||||
linkend="options-configure_on"/>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><varname>CMAKE_ARGS</varname></term>
|
||||
|
||||
<listitem>
|
||||
<para>For arguments that are booleans
|
||||
(<literal>on</literal>, <literal>off</literal>,
|
||||
<literal>true</literal>, <literal>false</literal>,
|
||||
<literal>0</literal>, <literal>1</literal>) see <xref
|
||||
linkend="options-cmake_bool"/>.</para>
|
||||
|
||||
<para>For all other cases, see <xref
|
||||
linkend="options-cmake_on"/>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><varname>MESON_ARGS</varname></term>
|
||||
<listitem>
|
||||
<para>For arguments that take <literal>true</literal> or
|
||||
<literal>false</literal>, see <xref
|
||||
linkend="options-meson_true"/>.</para>
|
||||
|
||||
<para>For arguments that take <literal>yes</literal> or
|
||||
<literal>no</literal>, use <xref
|
||||
linkend="options-meson_yes"/>.</para>
|
||||
|
||||
<para>For all other cases, use <xref
|
||||
linkend="options-meson_on"/>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><varname>QMAKE_ARGS</varname></term>
|
||||
|
||||
<listitem>
|
||||
<para>See <xref linkend="options-qmake_on"/>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><varname>USE_<replaceable>*</replaceable></varname></term>
|
||||
|
||||
<listitem>
|
||||
<para>See <xref linkend="options-use"/>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><varname><replaceable>*</replaceable>_DEPENDS</varname></term>
|
||||
|
||||
<listitem>
|
||||
<para>See <xref linkend="options-dependencies"/>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><replaceable>*</replaceable> (Any variable)</term>
|
||||
|
||||
<listitem>
|
||||
<para>The most used variables have direct helpers, see
|
||||
<xref linkend="options-variables"/>.</para>
|
||||
|
||||
<para>For any variable without a specific helper, see
|
||||
<xref linkend="options-vars"/>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Options dependencies</term>
|
||||
|
||||
<listitem>
|
||||
<para>When an option need another option to work, see
|
||||
<xref linkend="options-implies"/>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Options conflicts</term>
|
||||
|
||||
<listitem>
|
||||
<para>When an option cannot work if another is also
|
||||
enabled, see <xref linkend="options-prevents"/>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term>Build targets</term>
|
||||
|
||||
<listitem>
|
||||
<para>When an option need some extra processing, see <xref
|
||||
linkend="options-targets"/>.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<sect3 xml:id="options_sub">
|
||||
<title><varname>OPTIONS_SUB</varname></title>
|
||||
|
|
Loading…
Reference in a new issue