Changeset View
Changeset View
Standalone View
Standalone View
head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
Show First 20 Lines • Show All 229 Lines • ▼ Show 20 Lines | <sect1 xml:id="uses-bison"> | ||||
<para>Uses <package role="port">devel/bison</package> By default, | <para>Uses <package role="port">devel/bison</package> By default, | ||||
with no arguments or with the <literal>build</literal> argument, | with no arguments or with the <literal>build</literal> argument, | ||||
it implies <command>bison</command> is a build-time dependency, | it implies <command>bison</command> is a build-time dependency, | ||||
<literal>run</literal> implies a run-time dependency, and | <literal>run</literal> implies a run-time dependency, and | ||||
<literal>both</literal> implies both run-time and build-time | <literal>both</literal> implies both run-time and build-time | ||||
dependencies.</para> | dependencies.</para> | ||||
</sect1> | </sect1> | ||||
<sect1 xml:id="uses-cabal"> | |||||
<title><literal>cabal</literal></title> | |||||
<important> | |||||
<para>Ports should not be created for Haskell libraries, see | |||||
<xref linkend="haskell-libs"/> for more information.</para> | |||||
</important> | |||||
<para>Possible arguments: (none), <literal>hpack</literal></para> | |||||
<para>Sets default values and targets used to build | |||||
<application>Haskell</application> software using Cabal. | |||||
A build dependency on the Haskell compiler port (GHC) | |||||
is added. If <literal>hpack</literal> argument is given, | |||||
a build dependency on <package role="port">devel/hs-hpack</package> | |||||
is added and <command>hpack</command> is invoked at | |||||
configuration step to generate .cabal file.</para> | |||||
<para>The framework provides the following variables:</para> | |||||
<variablelist> | |||||
<varlistentry> | |||||
<term><varname>USE_CABAL</varname></term> | |||||
<listitem> | |||||
<para>If the software uses Haskell dependencies, list them in | |||||
this variable. Each item should be present on Hackage and | |||||
be listed in form <literal>packagename-<replaceable>0.1.2</replaceable></literal>. | |||||
Dependencies can have revisions, which are specified after the | |||||
<literal>_</literal> symbol. Automatic generation of dependency | |||||
list is supported, see <xref linkend="using-cabal"/>.</para> | |||||
</listitem> | |||||
</varlistentry> | |||||
<varlistentry> | |||||
<term><varname>CABAL_FLAGS</varname></term> | |||||
<listitem> | |||||
<para>List of flags to be passed to <command>cabal-install</command> | |||||
during the configuring and building stage. The flags are | |||||
passed verbatim.</para> | |||||
</listitem> | |||||
</varlistentry> | |||||
<varlistentry> | |||||
<term><varname>EXECUTABLES</varname></term> | |||||
<listitem> | |||||
<para>List of executable files installed by the port. | |||||
Default value: <varname>${PORTNAME}</varname>. | |||||
Items from this list are automatically added to pkg-plist.</para> | |||||
</listitem> | |||||
</varlistentry> | |||||
<varlistentry> | |||||
<term><varname>SKIP_CABAL_PLIST</varname></term> | |||||
<listitem> | |||||
<para>If defined, do not add items from | |||||
<varname>${EXECUTABLES}</varname> to pkg-plist.</para> | |||||
</listitem> | |||||
</varlistentry> | |||||
<varlistentry> | |||||
<term><varname>opt_USE_CABAL</varname></term> | |||||
<listitem> | |||||
<para>Adds items to <varname>${USE_CABAL}</varname> | |||||
depending on <literal>opt</literal> option.</para> | |||||
</listitem> | |||||
</varlistentry> | |||||
<varlistentry> | |||||
<term><varname>opt_EXECUTABLES</varname></term> | |||||
<listitem> | |||||
<para>Adds items to <varname>${EXECUTABLES}</varname> | |||||
depending on <literal>opt</literal> option.</para> | |||||
</listitem> | |||||
</varlistentry> | |||||
<varlistentry> | |||||
<term><varname>opt_CABAL_FLAGS</varname></term> | |||||
<listitem> | |||||
<para>If <option>opt</option> is enabled, append the value | |||||
to <varname>${CABAL_FLAGS}</varname>. Otherwise, append | |||||
<literal>-value</literal> to disable the flag.</para> | |||||
</listitem> | |||||
</varlistentry> | |||||
<varlistentry> | |||||
<term><varname>FOO_DATADIR_VARS</varname></term> | |||||
<listitem> | |||||
<para>For an executable named <literal>FOO</literal> | |||||
list Haskell packages, whose data files | |||||
should be accessible by the executable.</para> | |||||
</listitem> | |||||
</varlistentry> | |||||
</variablelist> | |||||
</sect1> | |||||
<sect1 xml:id="uses-cargo"> | <sect1 xml:id="uses-cargo"> | ||||
<title><literal>cargo</literal></title> | <title><literal>cargo</literal></title> | ||||
<para>Possible arguments: (none)</para> | <para>Possible arguments: (none)</para> | ||||
<para>Uses Cargo for configuring, building, and testing. | <para>Uses Cargo for configuring, building, and testing. | ||||
It can be used to port Rust applications that use the Cargo | It can be used to port Rust applications that use the Cargo | ||||
build system. For more information see <xref | build system. For more information see <xref | ||||
▲ Show 20 Lines • Show All 3,509 Lines • Show Last 20 Lines |