os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Indent all new sect4 one more level.

Browse source 
White-space only, translators can ignore.

Sponsored by:	Absolight
This commit is contained in:
Mathieu Arnold 2017-06-09 15:04:55 +00:00
parent c9c8768ded
commit 0c56cdcd35
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=50346
1 changed files with 109 additions and 109 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

218
en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
View file

@ -5702,32 +5702,32 @@ USE_OPENSSL= yes
<sect3 xml:id="options-configure-helpers">
<title><varname>CONFIGURE_ARGS</varname> Helpers</title>
<sect4 xml:id="options-configure_enable">
<title><varname><replaceable>OPT</replaceable>_CONFIGURE_ENABLE</varname></title>
<sect4 xml:id="options-configure_enable">
<title><varname><replaceable>OPT</replaceable>_CONFIGURE_ENABLE</varname></title>
<para>When option <replaceable>OPT</replaceable> is selected,
for each <replaceable>entry</replaceable> in
<varname><replaceable>OPT</replaceable>_CONFIGURE_ENABLE</varname>
then
<literal>--enable-<replaceable>entry</replaceable></literal>
is appended to <varname>CONFIGURE_ARGS</varname>. When
option <replaceable>OPT</replaceable> is
<emphasis>not</emphasis> selected,
<literal>--disable-<replaceable>entry</replaceable></literal>
is appended to <varname>CONFIGURE_ARGS</varname>. An
optional argument can be specified with an
<literal>=</literal> symbol. This argument is only appended
to the
<literal>--enable-<replaceable>entry</replaceable></literal>
configure option. For example:</para>
<para>When option <replaceable>OPT</replaceable> is selected,
for each <replaceable>entry</replaceable> in
<varname><replaceable>OPT</replaceable>_CONFIGURE_ENABLE</varname>
then
<literal>--enable-<replaceable>entry</replaceable></literal>
is appended to <varname>CONFIGURE_ARGS</varname>. When
option <replaceable>OPT</replaceable> is
<emphasis>not</emphasis> selected,
<literal>--disable-<replaceable>entry</replaceable></literal>
is appended to <varname>CONFIGURE_ARGS</varname>. An
optional argument can be specified with an
<literal>=</literal> symbol. This argument is only appended
to the
<literal>--enable-<replaceable>entry</replaceable></literal>
configure option. For example:</para>
<programlisting>OPTIONS_DEFINE= OPT1 OPT2
<programlisting>OPTIONS_DEFINE= OPT1 OPT2
OPT1_CONFIGURE_ENABLE= test1 test2
OPT2_CONFIGURE_ENABLE= test2=exhaustive</programlisting>
<para>is equivalent to:</para>
<para>is equivalent to:</para>
<programlisting>OPTIONS_DEFINE= OPT1
<programlisting>OPTIONS_DEFINE= OPT1
.include &lt;bsd.port.options.mk&gt;
@ -5742,34 +5742,34 @@ CONFIGURE_ARGS+= --enable-test2=exhaustive
.else
CONFIGURE_ARGS+= --disable-test2
.endif</programlisting>
</sect4>
</sect4>
<sect4 xml:id="options-configure_with">
<title><varname><replaceable>OPT</replaceable>_CONFIGURE_WITH</varname></title>
<sect4 xml:id="options-configure_with">
<title><varname><replaceable>OPT</replaceable>_CONFIGURE_WITH</varname></title>
<para>When option <replaceable>OPT</replaceable> is selected,
for each <replaceable>entry</replaceable> in
<varname><replaceable>OPT</replaceable>_CONFIGURE_WITH</varname>
then
<literal>--with-<replaceable>entry</replaceable></literal>
is appended to <varname>CONFIGURE_ARGS</varname>. When
option <replaceable>OPT</replaceable> is
<emphasis>not</emphasis> selected,
<literal>--without-<replaceable>entry</replaceable></literal>
is appended to <varname>CONFIGURE_ARGS</varname>. An
optional argument can be specified with an
<literal>=</literal> symbol. This argument is only appended
to the
<literal>--with-<replaceable>entry</replaceable></literal>
configure option. For example:</para>
<para>When option <replaceable>OPT</replaceable> is selected,
for each <replaceable>entry</replaceable> in
<varname><replaceable>OPT</replaceable>_CONFIGURE_WITH</varname>
then
<literal>--with-<replaceable>entry</replaceable></literal>
is appended to <varname>CONFIGURE_ARGS</varname>. When
option <replaceable>OPT</replaceable> is
<emphasis>not</emphasis> selected,
<literal>--without-<replaceable>entry</replaceable></literal>
is appended to <varname>CONFIGURE_ARGS</varname>. An
optional argument can be specified with an
<literal>=</literal> symbol. This argument is only appended
to the
<literal>--with-<replaceable>entry</replaceable></literal>
configure option. For example:</para>
<programlisting>OPTIONS_DEFINE= OPT1 OPT2
<programlisting>OPTIONS_DEFINE= OPT1 OPT2
OPT1_CONFIGURE_WITH= test1
OPT2_CONFIGURE_WITH= test2=exhaustive</programlisting>
<para>is equivalent to:</para>
<para>is equivalent to:</para>
<programlisting>OPTIONS_DEFINE= OPT1 OPT2
<programlisting>OPTIONS_DEFINE= OPT1 OPT2
.include &lt;bsd.port.options.mk&gt;
@ -5784,29 +5784,29 @@ CONFIGURE_ARGS+= --with-test2=exhaustive
.else
CONFIGURE_ARGS+= --without-test2
.endif</programlisting>
</sect4>
</sect4>
<sect4 xml:id="options-configure_on">
<title><varname><replaceable>OPT</replaceable>_CONFIGURE_ON</varname>
and
<varname><replaceable>OPT</replaceable>_CONFIGURE_OFF</varname></title>
<sect4 xml:id="options-configure_on">
<title><varname><replaceable>OPT</replaceable>_CONFIGURE_ON</varname>
and
<varname><replaceable>OPT</replaceable>_CONFIGURE_OFF</varname></title>
<para>When option <replaceable>OPT</replaceable> is selected,
the value of
<varname><replaceable>OPT</replaceable>_CONFIGURE_ON</varname>,
if defined, is appended to
<varname>CONFIGURE_ARGS</varname>.
<varname><replaceable>OPT</replaceable>_CONFIGURE_OFF</varname>
works the same way, but when <literal>OPT</literal> is
<emphasis>not</emphasis> selected. For example:</para>
<para>When option <replaceable>OPT</replaceable> is selected,
the value of
<varname><replaceable>OPT</replaceable>_CONFIGURE_ON</varname>,
if defined, is appended to
<varname>CONFIGURE_ARGS</varname>.
<varname><replaceable>OPT</replaceable>_CONFIGURE_OFF</varname>
works the same way, but when <literal>OPT</literal> is
<emphasis>not</emphasis> selected. For example:</para>
<programlisting>OPTIONS_DEFINE= OPT1
<programlisting>OPTIONS_DEFINE= OPT1
OPT1_CONFIGURE_ON= --add-test
OPT1_CONFIGURE_OFF= --no-test</programlisting>
<para>is equivalent to:</para>
<para>is equivalent to:</para>
<programlisting>OPTIONS_DEFINE= OPT1
<programlisting>OPTIONS_DEFINE= OPT1
.include &lt;bsd.port.options.mk&gt;
@ -5816,38 +5816,38 @@ CONFIGURE_ARGS+= --add-test
CONFIGURE_ARGS+= --no-test
.endif</programlisting>
<tip>
<para>Most of the time, the helpers in <xref
linkend="options-configure_enable"/> and <xref
linkend="options-configure_with"/> provide a shorter
and more comprehensive functionality.</para>
</tip>
</sect4>
<tip>
<para>Most of the time, the helpers in <xref
linkend="options-configure_enable"/> and <xref
linkend="options-configure_with"/> provide a shorter
and more comprehensive functionality.</para>
</tip>
</sect4>
</sect3>
<sect3 xml:id="options-cmake-helpers">
<title><varname>CMAKE_ARGS</varname> Helpers</title>
<sect4 xml:id="options-cmake_on">
<title><varname><replaceable>OPT</replaceable>_CMAKE_ON</varname>
and
<varname><replaceable>OPT</replaceable>_CMAKE_OFF</varname></title>
<sect4 xml:id="options-cmake_on">
<title><varname><replaceable>OPT</replaceable>_CMAKE_ON</varname>
and
<varname><replaceable>OPT</replaceable>_CMAKE_OFF</varname></title>
<para>When option <replaceable>OPT</replaceable> is selected,
the value of
<varname><replaceable>OPT</replaceable>_CMAKE_ON</varname>,
if defined, is appended to <varname>CMAKE_ARGS</varname>.
<varname><replaceable>OPT</replaceable>_CMAKE_OFF</varname>
works the same way, but when <literal>OPT</literal> is
<emphasis>not</emphasis> selected. For example:</para>
<para>When option <replaceable>OPT</replaceable> is selected,
the value of
<varname><replaceable>OPT</replaceable>_CMAKE_ON</varname>,
if defined, is appended to <varname>CMAKE_ARGS</varname>.
<varname><replaceable>OPT</replaceable>_CMAKE_OFF</varname>
works the same way, but when <literal>OPT</literal> is
<emphasis>not</emphasis> selected. For example:</para>
<programlisting>OPTIONS_DEFINE= OPT1
<programlisting>OPTIONS_DEFINE= OPT1
OPT1_CMAKE_ON= -DTEST:BOOL=true -DDEBUG:BOOL=true
OPT1_CMAKE_OFF= -DOPTIMIZE:BOOL=true</programlisting>
<para>is equivalent to:</para>
<para>is equivalent to:</para>
<programlisting>OPTIONS_DEFINE= OPT1
<programlisting>OPTIONS_DEFINE= OPT1
.include &lt;bsd.port.options.mk&gt;
@ -5857,43 +5857,43 @@ CMAKE_ARGS+= -DTEST:BOOL=true -DDEBUG:BOOL=true
CMAKE_ARGS+= -DOPTIMIZE:BOOL=true
.endif</programlisting>
<tip>
<para>See <xref linkend="options-cmake_bool"/> for a shorter
helper when the value is boolean.</para>
</tip>
</sect4>
<tip>
<para>See <xref linkend="options-cmake_bool"/> for a shorter
helper when the value is boolean.</para>
</tip>
</sect4>
<sect4 xml:id="options-cmake_bool">
<title><varname><replaceable>OPT</replaceable>_CMAKE_BOOL</varname>
and
<varname><replaceable>OPT</replaceable>_CMAKE_BOOL_OFF</varname></title>
<sect4 xml:id="options-cmake_bool">
<title><varname><replaceable>OPT</replaceable>_CMAKE_BOOL</varname>
and
<varname><replaceable>OPT</replaceable>_CMAKE_BOOL_OFF</varname></title>
<para>When option <replaceable>OPT</replaceable> is selected,
for each <replaceable>entry</replaceable> in
<varname><replaceable>OPT</replaceable>_CMAKE_BOOL</varname>
then
<literal>-D<replaceable>entry</replaceable>:BOOL=true</literal>
is appended to <varname>CMAKE_ARGS</varname>. When option
<replaceable>OPT</replaceable> is <emphasis>not</emphasis>
selected,
<literal>-D<replaceable>entry</replaceable>:BOOL=false</literal>
is appended to <varname>CONFIGURE_ARGS</varname>.
<varname><replaceable>OPT</replaceable>_CMAKE_BOOL_OFF</varname>
is the oposite,
<literal>-D<replaceable>entry</replaceable>:BOOL=false</literal>
is appended to <varname>CMAKE_ARGS</varname> when the option
is selected, and
<literal>-D<replaceable>entry</replaceable>:BOOL=true</literal>
when the option is <emphasis>not</emphasis> selected. For
example:</para>
<para>When option <replaceable>OPT</replaceable> is selected,
for each <replaceable>entry</replaceable> in
<varname><replaceable>OPT</replaceable>_CMAKE_BOOL</varname>
then
<literal>-D<replaceable>entry</replaceable>:BOOL=true</literal>
is appended to <varname>CMAKE_ARGS</varname>. When option
<replaceable>OPT</replaceable> is <emphasis>not</emphasis>
selected,
<literal>-D<replaceable>entry</replaceable>:BOOL=false</literal>
is appended to <varname>CONFIGURE_ARGS</varname>.
<varname><replaceable>OPT</replaceable>_CMAKE_BOOL_OFF</varname>
is the oposite,
<literal>-D<replaceable>entry</replaceable>:BOOL=false</literal>
is appended to <varname>CMAKE_ARGS</varname> when the option
is selected, and
<literal>-D<replaceable>entry</replaceable>:BOOL=true</literal>
when the option is <emphasis>not</emphasis> selected. For
example:</para>
<programlisting>OPTIONS_DEFINE= OPT1
<programlisting>OPTIONS_DEFINE= OPT1
OPT1_CMAKE_BOOL= TEST DEBUG
OPT1_CMAKE_BOOL_OFF= OPTIMIZE</programlisting>
<para>is equivalent to:</para>
<para>is equivalent to:</para>
<programlisting>OPTIONS_DEFINE= OPT1
<programlisting>OPTIONS_DEFINE= OPT1
.include &lt;bsd.port.options.mk&gt;
@ -5904,7 +5904,7 @@ CMAKE_ARGS+= -DTEST:BOOL=true -DDEBUG:BOOL=true \
CMAKE_ARGS+= -DTEST:BOOL=false -DDEBUG:BOOL=false \
-DOPTIMIZE:BOOL=true
.endif</programlisting>
</sect4>
</sect4>
</sect3>
<sect3 xml:id="options-qmake_on">