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 71 Lines • ▼ Show 20 Lines | <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink= | ||||
| </row> | </row> | ||||
| <row xml:id="uses-charsetfix"> | <row xml:id="uses-charsetfix"> | ||||
| <entry><literal>charsetfix</literal></entry> | <entry><literal>charsetfix</literal></entry> | ||||
| <entry>(none)</entry> | <entry>(none)</entry> | ||||
| <entry>Prevents the port from installing | <entry>Prevents the port from installing | ||||
| <filename>charset.alias</filename>. This should be | <filename>charset.alias</filename>. This must be | ||||
| installed only by | installed only by | ||||
| <package role="port">converters/libiconv</package>. | <package role="port">converters/libiconv</package>. | ||||
| <varname>CHARSETFIX_MAKEFILEIN</varname> can be set to a | <varname>CHARSETFIX_MAKEFILEIN</varname> can be set to a | ||||
| path relative to <varname>WRKSRC</varname> if | path relative to <varname>WRKSRC</varname> if | ||||
| <filename>charset.alias</filename> is not installed by | <filename>charset.alias</filename> is not installed by | ||||
| <varname>WRKSRC</varname>/<filename>Makefile.in</filename>.</entry> | <filename>${WRKSRC}/Makefile.in</filename>.</entry> | ||||
| </row> | </row> | ||||
| <row xml:id="uses-cmake"> | <row xml:id="uses-cmake"> | ||||
| <entry><literal>cmake</literal></entry> | <entry><literal>cmake</literal></entry> | ||||
| <entry>(none), <literal>outsource</literal>, | <entry>(none), <literal>outsource</literal>, | ||||
| <literal>run</literal></entry> | <literal>run</literal></entry> | ||||
| ▲ Show 20 Lines • Show All 556 Lines • ▼ Show 20 Lines | GSSAPI_NONE_CONFIGURE_ON= --without-gssapi</programlisting> | ||||
| <row xml:id="uses-libtool"> | <row xml:id="uses-libtool"> | ||||
| <entry><literal>libtool</literal></entry> | <entry><literal>libtool</literal></entry> | ||||
| <entry>(none), <literal>keepla</literal>, | <entry>(none), <literal>keepla</literal>, | ||||
| <literal>build</literal></entry> | <literal>build</literal></entry> | ||||
| <entry>Patches <command>libtool</command> scripts. This | <entry>Patches <command>libtool</command> scripts. This | ||||
| should be added to all ports that use | must be added to all ports that use | ||||
| <command>libtool</command>. The <literal>keepla</literal> | <command>libtool</command>. The <literal>keepla</literal> | ||||
| argument can be used to keep the <filename>.la</filename> | argument can be used to keep <filename>.la</filename> | ||||
| files. Some ports do not ship with their own copy of | files. Some ports do not ship with their own copy of | ||||
| libtool and need a build time dependency on <package | libtool and need a build time dependency on <package | ||||
| role="port">devel/libtool</package>, use the | role="port">devel/libtool</package>, use the | ||||
| <literal>:build</literal> argument to add such | <literal>:build</literal> argument to add such | ||||
| dependency.</entry> | dependency.</entry> | ||||
| </row> | </row> | ||||
| <row xml:id="uses-lua"> | <row xml:id="uses-lua"> | ||||
| <entry><literal>lua</literal></entry> | <entry><literal>lua</literal></entry> | ||||
| <entry>(none), | <entry>(none), | ||||
| <literal><replaceable>XY</replaceable>+</literal>, | <literal><replaceable>XY</replaceable>+</literal>, | ||||
| <literal><replaceable>XY</replaceable></literal>, | <literal><replaceable>XY</replaceable></literal>, | ||||
| <literal>build</literal>, | <literal>build</literal>, | ||||
| <literal>run</literal></entry> | <literal>run</literal></entry> | ||||
| <entry>Adds a dependency on <application>Lua</application>. | <entry>Adds a dependency on <application>Lua</application>. | ||||
| By default this is a library undependency, unless | By default this is a library undependency, unless | ||||
| overridden by the <literal>build</literal> or | overridden by the <literal>build</literal> or | ||||
| <literal>run</literal> option. The default version is | <literal>run</literal> option. The default version is | ||||
| 5.2, unless set by the | 5.2, unless set by the | ||||
| <literal><replaceable>XY</replaceable></literal> parameter | <literal><replaceable>XY</replaceable></literal> parameter | ||||
| (e.g., <literal>51</literal> or | (for example, <literal>51</literal> or | ||||
| <literal>52+</literal>).</entry> | <literal>52+</literal>).</entry> | ||||
| </row> | </row> | ||||
| <row xml:id="uses-makeinfo"> | <row xml:id="uses-makeinfo"> | ||||
| <entry><literal>makeinfo</literal></entry> | <entry><literal>makeinfo</literal></entry> | ||||
| <entry><literal>build</literal> (default), | <entry><literal>build</literal> (default), | ||||
| <literal>run</literal>, <literal>both</literal></entry> | <literal>run</literal>, <literal>both</literal></entry> | ||||
| ▲ Show 20 Lines • Show All 69 Lines • ▼ Show 20 Lines | <row xml:id="uses-openal"> | ||||
| <entry><literal>al</literal>, <literal>soft</literal> | <entry><literal>al</literal>, <literal>soft</literal> | ||||
| (default), <literal>si</literal>, | (default), <literal>si</literal>, | ||||
| <literal>alut</literal></entry> | <literal>alut</literal></entry> | ||||
| <entry>Uses <application>OpenAL</application>. The backend | <entry>Uses <application>OpenAL</application>. The backend | ||||
| can be specified, with the software implementation as the | can be specified, with the software implementation as the | ||||
| default. The user can specify a preferred backend with | default. The user can specify a preferred backend with | ||||
| the <varname>WANT_OPENAL</varname> knob. Valid values for | <varname>WANT_OPENAL</varname>. Valid values for | ||||
| this knob are <literal>soft</literal> (default) and | this knob are <literal>soft</literal> (default) and | ||||
| <literal>si</literal>.</entry> | <literal>si</literal>.</entry> | ||||
| </row> | </row> | ||||
| <row xml:id="uses-pathfix"> | <row xml:id="uses-pathfix"> | ||||
| <entry><literal>pathfix</literal></entry> | <entry><literal>pathfix</literal></entry> | ||||
| <entry>(none)</entry> | <entry>(none)</entry> | ||||
| <entry>Look for the <filename>Makefile.in</filename> and | <entry>Look for <filename>Makefile.in</filename> and | ||||
| <filename>configure</filename> files in the port's | <filename>configure</filename> in the port's | ||||
| associated sources and fix common paths to make sure they | associated sources and fix common paths to make sure they | ||||
| respect the &os; hierarchy. If the port uses | respect the &os; hierarchy. If the port uses | ||||
| <command>automake</command>, set | <command>automake</command>, set | ||||
| <varname>PATHFIX_MAKEFILEIN</varname> to | <varname>PATHFIX_MAKEFILEIN</varname> to | ||||
| <filename>Makefile.am</filename> if needed.</entry> | <filename>Makefile.am</filename> if needed.</entry> | ||||
| </row> | </row> | ||||
| <row xml:id="uses-perl5"> | <row xml:id="uses-perl5"> | ||||
| ▲ Show 20 Lines • Show All 41 Lines • ▼ Show 20 Lines | <para><varname>USE_PERL5</varname>: Phases in which to | ||||
| <literal>modbuild</literal>, or | <literal>modbuild</literal>, or | ||||
| <literal>modbuildtiny</literal> when | <literal>modbuildtiny</literal> when | ||||
| <filename>Makefile.PL</filename>, | <filename>Makefile.PL</filename>, | ||||
| <filename>Build.PL</filename>, or the | <filename>Build.PL</filename>, or the | ||||
| Module::Build::Tiny flavor of | Module::Build::Tiny flavor of | ||||
| <filename>Build.PL</filename> is required. If there | <filename>Build.PL</filename> is required. If there | ||||
| is a <filename>.packlist</filename> referencing | is a <filename>.packlist</filename> referencing | ||||
| <varname>${STAGEDIR}</varname>, then | <varname>${STAGEDIR}</varname>, then | ||||
| <literal>fixpacklist</literal> should be used to | <literal>fixpacklist</literal> must be used to | ||||
| patch it. It defaults to | patch it. It defaults to | ||||
| <literal>build run</literal>.</para> | <literal>build run</literal>.</para> | ||||
| </listitem> | </listitem> | ||||
| </itemizedlist></entry> | </itemizedlist></entry> | ||||
| </row> | </row> | ||||
| <row xml:id="uses-pgsql"> | <row xml:id="uses-pgsql"> | ||||
| <entry><literal>pgsql</literal></entry> | <entry><literal>pgsql</literal></entry> | ||||
| <entry>(none), | <entry>(none), | ||||
| <literal><replaceable>X.Y</replaceable></literal>, | <literal><replaceable>X.Y</replaceable></literal>, | ||||
| <literal><replaceable>X.Y</replaceable>+</literal>, | <literal><replaceable>X.Y</replaceable>+</literal>, | ||||
| <literal><replaceable>X.Y</replaceable>-</literal></entry> | <literal><replaceable>X.Y</replaceable>-</literal></entry> | ||||
| <entry> | <entry> | ||||
| <para>Provide support for PostgreSQL. Maintainer can | <para>Provide support for PostgreSQL. Maintainer can | ||||
| set version required. Minimum and maximum versions can | set version required. Minimum and maximum versions can | ||||
| be specified; e.g., 9.0-, 8.4+.</para> | be specified; for example, 9.0-, 8.4+.</para> | ||||
| <para>Add PostgreSQL component dependency, using | <para>Add PostgreSQL component dependency, using | ||||
| <literal>WANT_PGSQL=component[:target]</literal>. e.g., | <literal>WANT_PGSQL=component[:target]</literal>. for example, | ||||
| <literal>WANT_PGSQL=server:configure pltcl | <literal>WANT_PGSQL=server:configure pltcl | ||||
| plperl</literal> For the full list use | plperl</literal> For the full list use | ||||
| <command>make -V _USE_PGSQL_DEP</command>.</para> | <command>make -V _USE_PGSQL_DEP</command>.</para> | ||||
| </entry> | </entry> | ||||
| </row> | </row> | ||||
| <row xml:id="uses-pkgconfig"> | <row xml:id="uses-pkgconfig"> | ||||
| <entry><literal>pkgconfig</literal></entry> | <entry><literal>pkgconfig</literal></entry> | ||||
| ▲ Show 20 Lines • Show All 239 Lines • ▼ Show 20 Lines | GSSAPI_NONE_CONFIGURE_ON= --without-gssapi</programlisting> | ||||
| <row xml:id="uses-uidfix"> | <row xml:id="uses-uidfix"> | ||||
| <entry><literal>uidfix</literal></entry> | <entry><literal>uidfix</literal></entry> | ||||
| <entry>(none)</entry> | <entry>(none)</entry> | ||||
| <entry>Changes some default behavior (mostly variables) of | <entry>Changes some default behavior (mostly variables) of | ||||
| the build system to allow installing this port as a normal | the build system to allow installing this port as a normal | ||||
| user. Try this in your port before adding | user. Try this in the port before adding | ||||
| <literal>NEED_ROOT=yes</literal></entry> | <literal>NEED_ROOT=yes</literal></entry> | ||||
| </row> | </row> | ||||
| <row xml:id="uses-uniquefiles"> | <row xml:id="uses-uniquefiles"> | ||||
| <entry><literal>uniquefiles</literal></entry> | <entry><literal>uniquefiles</literal></entry> | ||||
| <entry>(none), <literal>dirs</literal></entry> | <entry>(none), <literal>dirs</literal></entry> | ||||
| <entry>Make files or directories 'unique', by adding a | <entry>Make files or directories 'unique', by adding a | ||||
| prefix or suffix. If the <literal>dirs</literal> argument | prefix or suffix. If the <literal>dirs</literal> argument | ||||
| is used, the port needs a prefix (a only a prefix) based | is used, the port needs a prefix (a only a prefix) based | ||||
| on <varname>UNIQUE_PREFIX</varname> for standard | on <varname>UNIQUE_PREFIX</varname> for standard | ||||
| directories <varname>DOCSDIR</varname>, | directories <varname>DOCSDIR</varname>, | ||||
| <varname>EXAMPLESDIR</varname>, | <varname>EXAMPLESDIR</varname>, | ||||
| <varname>DATADIR</varname>, <varname>WWWDIR</varname>, | <varname>DATADIR</varname>, <varname>WWWDIR</varname>, | ||||
| <varname>ETCDIR</varname>. The following variables are | <varname>ETCDIR</varname>. These variables are | ||||
| available for ports: | available for ports: | ||||
| <itemizedlist> | <itemizedlist> | ||||
| <listitem> | <listitem> | ||||
| <para><varname>UNIQUE_PREFIX</varname>: The prefix to | <para><varname>UNIQUE_PREFIX</varname>: The prefix to | ||||
| be used for directories and files. Default: | be used for directories and files. Default: | ||||
| <varname>${PKGNAMEPREFIX}</varname>.</para> | <varname>${PKGNAMEPREFIX}</varname>.</para> | ||||
| </listitem> | </listitem> | ||||
| ▲ Show 20 Lines • Show All 120 Lines • Show Last 20 Lines | |||||