svn commit: r50226 - head/en_US.ISO8859-1/books/porters-handbook/uses
Mathieu Arnold
mat at FreeBSD.org
Tue May 2 17:05:21 UTC 2017
Author: mat
Date: Tue May 2 17:05:20 2017
New Revision: 50226
URL: https://svnweb.freebsd.org/changeset/doc/50226
Log:
Keep up-to-date with changes in existing USES.
Sponsored by: Absolight
Modified:
head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Tue May 2 17:05:16 2017 (r50225)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Tue May 2 17:05:20 2017 (r50226)
@@ -8,19 +8,19 @@
<!--
- Document up-to date with r416240 revision of the ports tree.
+ Document up-to date with r439950 revision of the ports tree.
This file documents the values of the USES make variable. The
format is easy to grasp from the already-added entries below (or use
this scheme below as a skeleton):
-<sect1 xml:id="uses-FEATURE">
- <title><literal>FEATURE</literal></title>
+ <sect1 xml:id="uses-FEATURE">
+ <title><literal>FEATURE</literal></title>
- <para>Possible arguments: ARGUMENTS</para>
+ <para>Possible arguments: ARGUMENTS</para>
- <para>DESCRIPTION</para>
-</sect1>
+ <para>DESCRIPTION</para>
+ </sect1>
-->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink=
@@ -407,11 +407,14 @@
<title><literal>cran</literal></title>
<para>Possible arguments: (none),
- <literal>auto-plist</literal></para>
+ <literal>auto-plist</literal>,
+ <literal>compiles</literal></para>
<para>Uses the Comprehensive R Archive Network. Specify
<varname>auto-plist</varname> to automatically generate
- <filename>pkg-plist</filename>.</para>
+ <filename>pkg-plist</filename>. Specify
+ <literal>compiles</literal> if the port has code that need to be
+ compiled.</para>
</sect1>
<sect1 xml:id="uses-desktop-file-utils">
@@ -496,14 +499,14 @@
<sect1 xml:id="uses-drupal">
<title><literal>drupal</literal></title>
- <para>Possible arguments: <literal>6</literal>,
+ <para>Possible arguments:
<literal>7</literal>, <literal>module</literal>,
<literal>theme</literal></para>
<para>Automate installation of a port that is a
<application>Drupal</application> theme or module. Use with the
version of Drupal that the port is expecting. For example,
- <literal>USES=drupal:6,module</literal> says that this port
+ <literal>USES=drupal:7,module</literal> says that this port
creates a Drupal 6 module. A Drupal 7 theme can be specified
with <literal>USES=drupal:7,theme</literal>.</para>
</sect1>
@@ -711,6 +714,11 @@
should be listed in <varname>USE_GNOME</varname>. The available
components are:</para>
+ <!--
+ From any port with USES=gnome, run:
+ $ make -V '${_USE_GNOME_ALL:O:u:C,.*,<listitem> <para><literal>&</literal></para> </listitem> ,}'
+ replace all spaces with new lines and reindent.
+ -->
<itemizedlist>
<listitem>
<para><literal>atk</literal></para>
@@ -721,10 +729,6 @@
</listitem>
<listitem>
- <para><literal>atspi</literal></para>
- </listitem>
-
- <listitem>
<para><literal>cairo</literal></para>
</listitem>
@@ -745,10 +749,6 @@
</listitem>
<listitem>
- <para><literal>gal2</literal></para>
- </listitem>
-
- <listitem>
<para><literal>gconf2</literal></para>
</listitem>
@@ -805,10 +805,6 @@
</listitem>
<listitem>
- <para><literal>gnomespeech</literal></para>
- </listitem>
-
- <listitem>
<para><literal>gnomevfs2</literal></para>
</listitem>
@@ -853,10 +849,6 @@
</listitem>
<listitem>
- <para><literal>gtksharp10</literal></para>
- </listitem>
-
- <listitem>
<para><literal>gtksharp20</literal></para>
</listitem>
@@ -905,10 +897,6 @@
</listitem>
<listitem>
- <para><literal>libgda4</literal></para>
- </listitem>
-
- <listitem>
<para><literal>libgda5</literal></para>
</listitem>
@@ -917,10 +905,6 @@
</listitem>
<listitem>
- <para><literal>libgdamm</literal></para>
- </listitem>
-
- <listitem>
<para><literal>libgdamm5</literal></para>
</listitem>
@@ -1715,11 +1699,14 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa
<sect1 xml:id="uses-localbase">
<title><literal>localbase</literal></title>
- <para>Possible arguments: (none)</para>
+ <para>Possible arguments: (none), <literal>ldflags</literal></para>
<para>Ensures that libraries from dependencies in
<varname>LOCALBASE</varname> are used instead of the ones from
- the base system. Ports that depend on libraries that are also
+ the base system. Specify <literal>ldflags</literal> to add
+ <literal>-L${LOCALBASE}/lib</literal> to
+ <varname>LDFLAGS</varname> instead of <varname>LIBS</varname>.
+ Ports that depend on libraries that are also
present in the base system should use this. It is also used
internally by a few other <varname>USES</varname>.</para>
</sect1>
@@ -1854,6 +1841,10 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa
</listitem>
<listitem>
+ <para><literal>session</literal></para>
+ </listitem>
+
+ <listitem>
<para><literal>settingsdaemon</literal></para>
</listitem>
</itemizedlist>
@@ -1899,7 +1890,9 @@ USE_MATE= menus:build intlhack</programl
Fall back to the default version, MySQL-5.6. The possible
versions are <literal>55</literal>, <literal>55m</literal>,
<literal>55p</literal>, <literal>56</literal>,
- <literal>56p</literal>, <literal>57</literal>,
+ <literal>56p</literal>, <literal>56w</literal>,
+ <literal>57</literal>, <literal>57p</literal>,
+ <literal>80</literal>,
<literal>100m</literal>, and <literal>101m</literal>. The
<literal>m</literal> and <literal>p</literal> suffixes are for
the <application>MariaDB</application> and
@@ -1920,11 +1913,23 @@ USE_MATE= menus:build intlhack</programl
<sect1 xml:id="uses-mono">
<title><literal>mono</literal></title>
- <para>Possible arguments: (none)</para>
+ <para>Possible arguments: (none), <literal>nuget</literal></para>
<para>Adds a dependency on the <application>Mono</application>
(currently only C#) framework by setting the appropriate
dependencies.</para>
+
+ <para>Specify <literal>nuget</literal> when the port uses nuget
+ packages. <varname>NUGET_DEPENDS</varname> needs to be set with
+ the names and versions of the nuget packages in the format
+ <literal><replaceable>name</replaceable>=<replaceable>version</replaceable></literal>.
+ An optional package origin can be added using
+ <literal><replaceable>name</replaceable>=<replaceable>version</replaceable>:<replaceable>origin</replaceable></literal>.</para>
+
+ <para>The helper target, <buildtarget>buildnuget</buildtarget>,
+ will output the content of the <varname>NUGET_DEPENDS</varname>
+ based on the provided
+ <filename>packages.config</filename>.</para>
</sect1>
<sect1 xml:id="uses-motif">
@@ -1954,9 +1959,8 @@ USE_MATE= menus:build intlhack</programl
<para>Possible arguments: (none)</para>
- <para>Uses <application>ninja</application> to build the port.
- End users can set <varname>NINJA_VERBOSE</varname> for verbose
- output.</para>
+ <para>Uses <application>ninja</application> to build the
+ port.</para>
</sect1>
<sect1 xml:id="uses-objc">
@@ -1996,9 +2000,9 @@ USE_MATE= menus:build intlhack</programl
hierarchy. For example, it fixes the installation directory
of <command>pkgconfig</command>'s <filename>.pc</filename> files
to <filename>${PREFIX}/libdata/pkgconfig</filename>. If
- the port uses <command>automake</command>, set
- <varname>PATHFIX_MAKEFILEIN</varname> to
- <filename>Makefile.am</filename> if needed.</para>
+ the port uses <literal>USES=autoreconf</literal>,
+ <filename>Makefile.am</filename> will be added to
+ <varname>PATHFIX_MAKEFILEIN</varname> automatically.</para>
<para>If the port <link
linkend="uses-cmake"><literal>USES=cmake</literal></link> it
@@ -2095,7 +2099,8 @@ USE_MATE= menus:build intlhack</programl
<literal>ext</literal>, <literal>zend</literal>,
<literal>build</literal>, <literal>cli</literal>,
<literal>cgi</literal>, <literal>mod</literal>,
- <literal>web</literal>, <literal>embed</literal></para>
+ <literal>web</literal>, <literal>embed</literal>,
+ <literal>pecl</literal></para>
<para>Provide support for <application>PHP</application>. Add a
runtime dependency on the default PHP version, <package
@@ -2174,6 +2179,15 @@ USE_MATE= menus:build intlhack</programl
<application>PHP</application>.</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><literal>pecl</literal></term>
+ <listitem>
+ <para>Provide defaults for fetching
+ <application>PHP</application> extensions from the PECL
+ repository.</para>
+ </listitem>
+ </varlistentry>
</variablelist>
<para>Variables are used to specify which
@@ -2583,12 +2597,20 @@ USE_PYQT= core doc_build designer_run</p
interpreters, most notably <filename>/usr/bin/perl</filename>
and <filename>/bin/bash</filename>. The shebagngfix macro fixes
shebang lines in scripts listed in
- <varname>SHEBANG_FILES</varname>. The shebangfix macro is run
- from <literal>${WRKSRC}</literal>, so it can contain paths that
+ <varname>SHEBANG_REGEX</varname>,
+ <varname>SHEBANG_GLOB</varname>, or
+ <varname>SHEBANG_FILES</varname>.
+ <varname>SHEBANG_REGEX</varname> contains an extended regular
+ expressions, and is used with the <literal>-iregex</literal>
+ argument of &man.find.1;. <varname>SHEBANG_GLOB</varname>
+ contains a pattern used with the <literal>-name</literal>
+ argument of &man.find.1;. The shebangfix macro is run
+ from <literal>${WRKSRC}</literal>, so
+ <varname>SHEBANG_FILES</varname> can contain paths that
are relative to <literal>${WRKSRC}</literal>. It can also deal
with absolute paths if files outside of
<literal>${WRKSRC}</literal> require patching. For
- example:</para>
+ example when using <varname>SHEBANG_FILES</varname>:</para>
<programlisting>USES= shebangfix
SHEBANG_FILES= scripts/foobar.pl scripts/*.sh</programlisting>
@@ -2636,7 +2658,8 @@ SHEBANG_FILES= scripts/foobar.pl scripts
<varname><replaceable>interp</replaceable>_OLD_CMD</varname>:
<literal>"/usr/bin/env <replaceable>interp</replaceable>"
/bin/<replaceable>interp</replaceable>
- /usr/bin/<replaceable>interp</replaceable></literal>.</para>
+ /usr/bin/<replaceable>interp</replaceable>
+ /usr/local/bin/<replaceable>interp</replaceable></literal>.</para>
</listitem>
</varlistentry>
</variablelist>
More information about the svn-doc-head
mailing list