svn commit: r51819 - in head/en_US.ISO8859-1/books/porters-handbook: makefiles special
Tobias Kortkamp
tobik at FreeBSD.org
Mon Jun 11 11:15:13 UTC 2018
Author: tobik (ports committer)
Date: Mon Jun 11 11:15:11 2018
New Revision: 51819
URL: https://svnweb.freebsd.org/changeset/doc/51819
Log:
Remove mention of some old WANT_* and USE_* variables from the Porter's Handbook
WANT_PHP_WEB
USE_FIREFOX*
USE_SEAMONKEY*
USE_THUNDERBIRD*
WANT_GNOME
HAVE_GNOME
USE_BDB
USE_PGSQL
USE_SQLITE
are all not supported anymore or have been replaced by USES=x.
Rewrite "Using Databases", add examples, and point to the various
USES macros for dealing with database dependencies.
Approved by: mat
Differential Revision: https://reviews.freebsd.org/D15704
Modified:
head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Mon Jun 11 09:30:42 2018 (r51818)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Mon Jun 11 11:15:11 2018 (r51819)
@@ -5895,45 +5895,6 @@ BAR_LIB_DEPENDS= libbar.so:foo/bar</programlisting>
installation, and updating of these ports and their
packages.</para>
</sect2>
-
- <sect2 xml:id="use-want">
- <title><varname>USE_<replaceable>*</replaceable></varname> and
- <varname>WANT_<replaceable>*</replaceable></varname></title>
-
- <para><varname>USE_<replaceable>*</replaceable></varname> are
- set by the port maintainer to define software on which this
- port depends. A port that needs Firefox would set</para>
-
- <programlisting>USE_FIREFOX= yes</programlisting>
-
- <para>Some <varname>USE_<replaceable>*</replaceable></varname>
- can accept version numbers or other parameters. For example,
- a port that requires Apache 2.2 would set</para>
-
- <programlisting>USE_APACHE= 22</programlisting>
-
- <para>For more control over dependencies in some cases,
- <varname>WANT_<replaceable>*</replaceable></varname> are
- available to more precisely specify what is needed. For
- example, consider the <package
- role="port">mail/squirrelmail</package> port. This
- port needs some PHP modules, which are listed in
- <varname>USE_PHP</varname>:</para>
-
- <programlisting>USE_PHP= session mhash gettext mbstring pcre openssl xml</programlisting>
-
- <para>Those modules may be available in CLI or web versions, so
- the web version is selected with
- <varname>WANT_<replaceable>*</replaceable></varname>:</para>
-
- <programlisting>WANT_PHP_WEB= yes</programlisting>
-
- <para>Available
- <varname>USE_<replaceable>*</replaceable></varname> and
- <varname>WANT_<replaceable>*</replaceable></varname> are
- defined in the files in
- <filename>/usr/ports/Mk</filename>.</para>
- </sect2>
</sect1>
<sect1 xml:id="makefile-masterdir">
Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Mon Jun 11 09:30:42 2018 (r51818)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Mon Jun 11 11:15:11 2018 (r51819)
@@ -2519,28 +2519,6 @@ GLIB_SCHEMAS= org.regexxer.gschema.xml
<tbody>
<row>
- <entry><literal>HAVE_GNOME</literal></entry>
- <entry>Deprecated, do not use. Was used to check if a
- component was installed. This was used for ports
- that did not have
- <literal>--enable</literal>/<literal>--disable</literal>
- switches for their configure script. But the building
- of parts of a port without a implicit request is
- discouraged.</entry>
- </row>
-
- <row>
- <entry><literal>WANT_GNOME</literal></entry>
- <entry>Deprecated, do not use. Was used by ports that
- needed <varname>USE_GNOME</varname> for optional
- dependencies, which where defined after
- <filename>bsd.port.pre.mk</filename>. Since
- <varname>USE_GNOME</varname> can be used after the
- inclusion of <filename>bsd.port.options.mk</filename>,
- there is little need for this macro any more.</entry>
- </row>
-
- <row>
<entry><literal>pangox-compat</literal></entry>
<entry><application>pangox-compat</application> has been
deprecated and split off from the
@@ -5386,127 +5364,95 @@ USE_XFCE= libexo libmenu libutil panel</programlisting
</tip>
</sect1>
- <sect1 xml:id="using-mozilla">
- <title>Using Mozilla</title>
+ <sect1 xml:id="using-databases">
+ <title>Using Databases</title>
- <table frame="none" xml:id="using-mozilla-variables">
- <title>Variables for Ports That Use Mozilla</title>
+ <para>Use one of the <varname>USES</varname> macros from
+ <xref linkend="using-databases-uses" /> to add a dependency
+ on a database.</para>
- <tgroup cols="2">
- <tbody>
+ <table frame="none" xml:id="using-databases-uses">
+ <title>Database <varname>USES</varname> Macros</title>
+ <tgroup cols="2">
+ <thead>
<row>
- <entry><varname>USE_GECKO</varname></entry>
- <entry>Gecko backend the port can handle. Possible
- values: <literal>libxul</literal>
- (<filename>libxul.so</filename>),
- <literal>seamonkey</literal>
- (<filename>libgtkembedmoz.so</filename>, deprecated,
- must not be used any more).</entry>
+ <entry>Database</entry>
+ <entry><varname>USES</varname> Macro</entry>
</row>
+ </thead>
+ <tbody>
<row>
- <entry><varname>USE_FIREFOX</varname></entry>
- <entry>The port requires Firefox as a runtime
- dependency. Possible values: <literal>yes</literal>
- (get default version), <literal>40</literal>,
- <literal>36</literal>, <literal>35</literal>. Default
- dependency is on version
- <literal>40</literal>.</entry>
+ <entry>Berkeley DB</entry>
+ <entry><link
+ linkend="uses-bdb"><literal>bdb</literal></link></entry>
</row>
<row>
- <entry><varname>USE_FIREFOX_BUILD</varname></entry>
- <entry>The port requires Firefox as a buildtime
- dependency. Possible values: see USE_FIREFOX. This
- automatically sets USE_FIREFOX and assigns the same
- value.</entry>
+ <entry>MariaDB, MySQL, Percona</entry>
+ <entry><link
+ linkend="uses-mysql"><literal>mysql</literal></link></entry>
</row>
<row>
- <entry><varname>USE_SEAMONKEY</varname></entry>
- <entry>The port requires SeaMonkey as a runtime
- dependency. Possible values: <literal>yes</literal>
- (get default version), <literal>20</literal>,
- <literal>11</literal> (deprecated, must not be used
- any more). Default dependency is on version
- <literal>20</literal>.</entry>
+ <entry>PostgreSQL</entry>
+ <entry><link
+ linkend="uses-pgsql"><literal>pgsql</literal></link></entry>
</row>
<row>
- <entry><varname>USE_SEAMONKEY_BUILD</varname></entry>
- <entry>The port requires SeaMonkey as a buildtime
- dependency. Possible values: see USE_SEAMONKEY. This
- automatically sets USE_SEAMONKEY and assigns the same
- value.</entry>
+ <entry>SQLite</entry>
+ <entry><link
+ linkend="uses-sqlite"><literal>sqlite</literal></link></entry>
</row>
-
- <row>
- <entry><varname>USE_THUNDERBIRD</varname></entry>
- <entry>The port requires Thunderbird as a runtime
- dependency. Possible values: <literal>yes</literal>
- (get default version), <literal>31</literal>,
- <literal>30</literal> (deprecated, must not be used
- any more). Default dependency is on version
- <literal>31</literal>.</entry>
- </row>
-
- <row>
- <entry><varname>USE_THUNDERBIRD_BUILD</varname></entry>
- <entry>The port requires Thunderbird as a buildtime
- dependency. Possible values: see USE_THUNDERBIRD.
- This automatically sets USE_THUNDERBIRD and assigns
- the same value.</entry>
- </row>
</tbody>
</tgroup>
</table>
- <para>A complete list of available variables can be found in
- <filename>/usr/ports/Mk/bsd.gecko.mk</filename>.</para>
- </sect1>
+ <example xml:id="using-databases-bdb-ex1">
+ <title>Using Berkeley DB 6</title>
- <sect1 xml:id="using-databases">
- <title>Using Databases</title>
+ <programlisting>USES= bdb:6</programlisting>
- <table frame="none" xml:id="using-databases-variables">
- <title>Variables for Ports Using Databases</title>
+ <para>See <xref linkend="uses-bdb" /> for more
+ information.</para>
+ </example>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>Variable</entry>
- <entry>Means</entry>
- </row>
- </thead>
+ <example xml:id="using-databases-mysql-ex1">
+ <title>Using MySQL</title>
- <tbody>
- <row>
- <entry><varname>USE_BDB</varname></entry>
- <entry>Obsolete. Replaced by <link
- linkend="uses-bdb"><literal>USES=bdb</literal></link></entry>
- </row>
+ <para>When a port needs the <application>MySQL</application>
+ client library add</para>
- <row>
- <entry><varname>USE_MYSQL</varname></entry>
- <entry>Obsolete. Replaced by <link
- linkend="uses-mysql"><literal>USES=mysql</literal></link></entry>
- </row>
+ <programlisting>USES= mysql</programlisting>
- <row>
- <entry><varname>USE_PGSQL</varname></entry>
- <entry>Obsolete. Replaced by <link
- linkend="uses-pgsql"><literal>USES=pgsql</literal></link>.</entry>
- </row>
+ <para>See <xref linkend="uses-mysql" /> for more
+ information.</para>
+ </example>
- <row>
- <entry><varname>USE_SQLITE</varname></entry>
- <entry>Obsolete. Replaced by <link
- linkend="uses-sqlite"><literal>USES=sqlite</literal></link></entry>
- </row>
- </tbody>
- </tgroup>
- </table>
+ <example xml:id="using-databases-pgsql-ex1">
+ <title>Using PostgreSQL</title>
+
+ <para>When a port needs the
+ <application>PostgreSQL</application> server version 9.6
+ or later add</para>
+
+ <programlisting>USES= pgsql:9.6+
+WANT_PGSQL= server</programlisting>
+
+ <para>See <xref linkend="uses-pgsql" /> for more
+ information.</para>
+ </example>
+
+ <example xml:id="using-databases-sqlite-ex1">
+ <title>Using SQLite 3</title>
+
+ <programlisting>USES= sqlite:3</programlisting>
+
+ <para>See <xref linkend="uses-sqlite" /> for more
+ information.</para>
+ </example>
</sect1>
<sect1 xml:id="rc-scripts">
More information about the svn-doc-head
mailing list