Changeset View
Standalone View
en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
Show First 20 Lines • Show All 4,419 Lines • ▼ Show 20 Lines | <listitem> | ||||
<para><varname>LIB_DEPENDS</varname></para> | <para><varname>LIB_DEPENDS</varname></para> | ||||
</listitem> | </listitem> | ||||
<listitem> | <listitem> | ||||
<para><varname>RUN_DEPENDS</varname></para> | <para><varname>RUN_DEPENDS</varname></para> | ||||
</listitem> | </listitem> | ||||
</itemizedlist> | </itemizedlist> | ||||
<para>The following variables can be used.</para> | |||||
<sect4> | <sect4> | ||||
<title><varname><replaceable>OPT</replaceable>_<replaceable>ABOVEVARIABLE</replaceable></varname></title> | <title><varname><replaceable>OPT</replaceable>_<replaceable>ABOVEVARIABLE</replaceable></varname></title> | ||||
<para>When option <replaceable>OPT</replaceable> is | <para>When option <replaceable>OPT</replaceable> is | ||||
selected, the value of | selected, the value of | ||||
<varname><replaceable>OPT</replaceable>_<replaceable>ABOVEVARIABLE</replaceable></varname>, | <varname><replaceable>OPT</replaceable>_<replaceable>ABOVEVARIABLE</replaceable></varname>, | ||||
if defined, is appended to | if defined, is appended to | ||||
<literal><replaceable>ABOVEVARIABLE</replaceable></literal>. | <literal><replaceable>ABOVEVARIABLE</replaceable></literal>. | ||||
▲ Show 20 Lines • Show All 133 Lines • ▼ Show 20 Lines | <listitem> | ||||
<para><varname>PLIST_SUB</varname></para> | <para><varname>PLIST_SUB</varname></para> | ||||
</listitem> | </listitem> | ||||
<listitem> | <listitem> | ||||
<para><varname>USES</varname></para> | <para><varname>USES</varname></para> | ||||
</listitem> | </listitem> | ||||
</itemizedlist> | </itemizedlist> | ||||
<para>The following variables can be used.</para> | |||||
<note> | <note> | ||||
<para>Some variables are not in this list, in particular | <para>Some variables are not in this list, in particular | ||||
<varname>PKGNAMEPREFIX</varname> and | <varname>PKGNAMEPREFIX</varname> and | ||||
<varname>PKGNAMESUFFIX</varname>. This is intentional. A | <varname>PKGNAMESUFFIX</varname>. This is intentional. A | ||||
port <emphasis>must not</emphasis> change its name when | port <emphasis>must not</emphasis> change its name when | ||||
its option set changes.</para> | its option set changes.</para> | ||||
</note> | </note> | ||||
▲ Show 20 Lines • Show All 70 Lines • ▼ Show 20 Lines | OPT1_USES_OFF= gmake</programlisting> | ||||
<programlisting>OPTIONS_DEFINE= OPT1 | <programlisting>OPTIONS_DEFINE= OPT1 | ||||
.include <bsd.port.options.mk> | .include <bsd.port.options.mk> | ||||
.if ! ${PORT_OPTIONS:MOPT1} | .if ! ${PORT_OPTIONS:MOPT1} | ||||
USES+= gmake | USES+= gmake | ||||
.endif</programlisting> | .endif</programlisting> | ||||
</sect4> | |||||
</sect3> | |||||
<sect3 xml:id="options-targets"> | |||||
<title>Generic Target Additions</title> | |||||
wblock: This should be Target. The plural is "Target Additions". | |||||
Not Done Inline ActionsI'm not very happy with the title, but I can't think of anything else. mat: I'm not very happy with the title, but I can't think of anything else. | |||||
Not Done Inline ActionsNon-native English speakers often have trouble with the meaning of the word "generic". wblock: Non-native English speakers often have trouble with the meaning of the word "generic". | |||||
Done Inline ActionsWhat would you propose ? mat: What would you propose ? | |||||
Done Inline ActionsGood question. Need more description of these targets to make a guess. What are these targets? "General-Purpose"? wblock: Good question. Need more description of these targets to make a guess. What are these targets? | |||||
Done Inline ActionsMmmm, well, the ports tree provide targets, like pre-extract, post-configure, post-install, so that you can add things before or after the normal building process of the software, so that it fetches/extracts/patches/builds/... correctly. These helpers are here to help you add to these targets when enabling or disabling options. It's explained in the summary of D2944. mat: Mmmm, well, the ports tree provide targets, like pre-extract, post-configure, post-install, so… | |||||
Done Inline Actionsping ? 0:-) mat: ping ? 0:-) | |||||
Done Inline Actions"Additional Build Targets"? wblock: "Additional Build Targets"? | |||||
<para>For any of these targets:</para> | |||||
Not Done Inline ActionsIs there some kind of continuation of this sentence after the list? Seems incomplete. wblock: Is there some kind of continuation of this sentence after the list? Seems incomplete. | |||||
Not Done Inline ActionsI basically copied the previous section and replaced, variable with target :-) mat: I basically copied the previous section and replaced, variable with target :-) | |||||
Done Inline ActionsIt's only the first half of a sentence. For any of these targets: And then it ends. Or Phabricator doesn't show it. But it seems to start, show some targets, and then doesn't say anything about them or what they are. wblock: It's only the first half of a sentence.
For any of these targets:
a
b
c
And then it ends. Or… | |||||
Done Inline ActionsWell, the end of the sentence is the two sub-sections after. mat: Well, the end of the sentence is the two sub-sections after. | |||||
Done Inline ActionsThe confusion is because it says: For any of these targets: ...list... The following build targets can be used. That is really one sentence, and capitalizing "The" makes it look like a second sentence. Better to split those apart: These <filename>Makefile</filename> targets can accept optional extra build targets: ...list... The additional build targets are listed below. wblock: The confusion is because it says:
For any of these targets:
...list...
The following build… | |||||
<itemizedlist> | |||||
<listitem> | |||||
<para><buildtarget>pre-fetch</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>post-fetch</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>pre-extract</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>post-extract</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>pre-patch</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>post-patch</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>pre-configure</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>post-configure</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>pre-build</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>post-build</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>pre-install</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>post-install</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>pre-package</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>post-package</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>pre-stage</buildtarget></para> | |||||
</listitem> | |||||
<listitem> | |||||
<para><buildtarget>post-stage</buildtarget></para> | |||||
</listitem> | |||||
</itemizedlist> | |||||
<para>The following build targets can be used.</para> | |||||
Not Done Inline ActionsWorking on this. :) wblock: Working on this. :)
| |||||
<sect4 xml:id="options-targets-on"> | |||||
<!-- XXX: Should be <buildtarget> and not <literal> --> | |||||
<title><literal><replaceable>ABOVETARGET</replaceable>-<replaceable>OPT</replaceable>-on</literal></title> | |||||
wblockUnsubmitted Done Inline Actions<buildtarget> should be usable here now. Please test. wblock: <buildtarget> should be usable here now. Please test. | |||||
<para>When option <replaceable>OPT</replaceable> is | |||||
selected, the target | |||||
<buildtarget><replaceable>ABOVETARGET</replaceable>-<replaceable>OPT</replaceable>-on</buildtarget>, | |||||
if defined, is executed after | |||||
<buildtarget><replaceable>ABOVETARGET</replaceable></buildtarget>. | |||||
For example:</para> | |||||
<programlisting>OPTIONS_DEFINE= OPT1 | |||||
post-patch-OPT1-on: | |||||
@${REINPLACE_CMD} -e '/opt1/d' ${WRKSRC}/Makefile</programlisting> | |||||
<para>is equivalent to:</para> | |||||
<programlisting>OPTIONS_DEFINE= OPT1 | |||||
.include <bsd.port.options.mk> | |||||
post-patch: | |||||
.if ${PORT_OPTIONS:MOPT1} | |||||
@${REINPLACE_CMD} -e '/opt1/d' ${WRKSRC}/Makefile | |||||
.endif</programlisting> | |||||
</sect4> | |||||
<sect4 xml:id="options-targets-off"> | |||||
<!-- XXX: Should be <buildtarget> and not <literal> --> | |||||
<title><literal><replaceable>ABOVETARGET</replaceable>-<replaceable>OPT</replaceable>-off</literal></title> | |||||
<para>When option <replaceable>OPT</replaceable> is | |||||
not selected, the target | |||||
<buildtarget><replaceable>ABOVETARGET</replaceable>-<replaceable>OPT</replaceable>-off</buildtarget>, | |||||
if defined, is executed after | |||||
<buildtarget><replaceable>ABOVETARGET</replaceable></buildtarget>. | |||||
For example:</para> | |||||
<programlisting>OPTIONS_DEFINE= OPT1 | |||||
post-patch-OPT1-off: | |||||
@${REINPLACE_CMD} -e '/opt1/d' ${WRKSRC}/Makefile</programlisting> | |||||
<para>is equivalent to:</para> | |||||
<programlisting>OPTIONS_DEFINE= OPT1 | |||||
.include <bsd.port.options.mk> | |||||
post-patch: | |||||
.if !${PORT_OPTIONS:MOPT1} | |||||
@${REINPLACE_CMD} -e '/opt1/d' ${WRKSRC}/Makefile | |||||
.endif</programlisting> | |||||
</sect4> | </sect4> | ||||
</sect3> | </sect3> | ||||
</sect2> | </sect2> | ||||
</sect1> | </sect1> | ||||
<sect1 xml:id="makefile-wrkdir"> | <sect1 xml:id="makefile-wrkdir"> | ||||
<title>Specifying the Working Directory</title> | <title>Specifying the Working Directory</title> | ||||
▲ Show 20 Lines • Show All 447 Lines • Show Last 20 Lines |
This should be Target. The plural is "Target Additions".