Date: Wed, 27 Apr 2016 13:55:31 +0000 (UTC) From: Mathieu Arnold <mat@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r48737 - in head/en_US.ISO8859-1/books/porters-handbook: special uses Message-ID: <201604271355.u3RDtVq5054710@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: mat Date: Wed Apr 27 13:55:31 2016 New Revision: 48737 URL: https://svnweb.freebsd.org/changeset/doc/48737 Log: Document the recent bsd.databases.mk changes. - SQLite has been USES=sqlite for a long time. - USE_BDB is now USES=bdb. - USE_MYSQL is now USES=mysql. Reviewed by: wblock Sponsored by: Absolight Differential Revision: https://reviews.freebsd.org/D6123 Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Tue Apr 26 13:00:32 2016 (r48736) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Wed Apr 27 13:55:31 2016 (r48737) @@ -5177,46 +5177,27 @@ USE_XFCE= libexo libmenu libutil panel</ <tbody> <row> - <entry><varname>USE_BDB</varname></entry> - <entry>If variable is set to <literal>yes</literal>, - add dependency on - <package role="port">databases/db5</package> - port. The variable may also be set to values: 48, 5 - or 6. It is possible to declare a range of acceptable - values, <varname>USE_BDB</varname>=48+ will find the - highest installed version, and fall back to 4.8 if - nothing else is installed. - <varname>WANT_BDB_VER</varname> will always build this - port with a specific version of the Berkely DB. - <varname>INVALID_BDB_VER</varname> can be used to - specify a version that cannot be used.</entry> + <entry>USE_BDB</entry> + <entry>Obsolete. Replaced by <link + linkend="uses-bdb"><literal>USES=bdb</literal></link></entry> </row> <row> <entry><varname>USE_MYSQL</varname></entry> - <entry>If the variable is set to <literal>yes</literal>, - add a dependency on the <package - role="port">databases/mysql56-client</package> port. - An associated variable, - <varname>WANT_MYSQL_VER</varname>, may be set to - values such as 51, 55, or 60. Additionally to - specify use of Percona, use 56p, or for MariaDB, use - 53m, 55m or 100m.</entry> + <entry>Obsolete. Replaced by <link + linkend="uses-mysql"><literal>USES=mysql</literal></link></entry> </row> <row> <entry><varname>USE_PGSQL</varname></entry> - <entry>Retired in favor of <link + <entry>Obsolete. Replaced by <link linkend="uses-pgsql"><literal>USES=pgsql</literal></link>.</entry> </row> <row> <entry><varname>USE_SQLITE</varname></entry> - <entry>If set to <literal>yes</literal>, add - dependency on - <package role="port">databases/sqlite3</package> - port. The variable may also be set to 3 or 2, to add - a dependency on 3.x or 2.x, respectively.</entry> + <entry>Obsolete. Replaced by <link + linkend="uses-sqlite"><literal>USES=sqlite</literal></link></entry> </row> </tbody> </tgroup> Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Tue Apr 26 13:00:32 2016 (r48736) +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Wed Apr 27 13:55:31 2016 (r48737) @@ -136,6 +136,92 @@ <para>Adds dependencies on Blas / Lapack libraries.</para> </sect1> + <sect1 xml:id="uses-bdb"> + <title><literal>bdb</literal></title> + + <para>Possible arguments: (none), <literal>48</literal>, + <literal>5</literal> (default), <literal>6</literal></para> + + <para>Add dependency on the <application>Berkeley DB</application> + library. Default to <package + role="port">databases/db5</package>. It can also depend on + <package role="port">databases/db48</package> when using the + <literal>:48</literal> argument or <package + role="port">databases/db6</package> with + <literal>:6</literal>. It is possible to declare a range of + acceptable values, <literal>:48+</literal> finds the highest + installed version, and falls back to 4.8 if nothing else is + installed. <varname>INVALID_BDB_VER</varname> can be used to + specify versions which do not work with this port. The + framework exposes the following variables to the port:</para> + + <variablelist> + <varlistentry> + <term><varname>BDB_LIB_NAME</varname></term> + + <listitem> + <para>The name of the <application>Berkeley DB</application> + library. For example, when using <package + role="port">databases/db5</package>, it contains + <literal>db-5.3</literal>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><varname>BDB_LIB_CXX_NAME</varname></term> + + <listitem> + <para>The name of the <application>Berkeley DB</application> + <application>C++</application> library. For example, when + using <package role="port">databases/db5</package>, it + contains <literal>db_cxx-5.3</literal>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><varname>BDB_INCLUDE_DIR</varname></term> + + <listitem> + <para>The location of the <application>Berkeley + DB</application> include directory. For example, when + using <package role="port">databases/db5</package>, it + will contain + <literal>${LOCALBASE}/include/db5</literal>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><varname>BDB_LIB_DIR</varname></term> + + <listitem> + <para>The location of the <application>Berkeley + DB</application> library directory. For example, when + using <package role="port">databases/db5</package>, it + contains <literal>${LOCALBASE}/lib</literal>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><varname>BDB_VER</varname></term> + + <listitem> + <para>The detected <application>Berkeley DB</application> + version. For example, if using + <literal>USES=bdb:48+</literal> and <application>Berkeley + DB</application> 5 is installed, it contains + <literal>5</literal>.</para> + </listitem> + </varlistentry> + </variablelist> + + + <important> + <para><package role="port">databases/db48</package> is + deprecated and unsupported. It must not be used by any + port.</para> + </important> + </sect1> + <sect1 xml:id="uses-bison"> <title><literal>bison</literal></title> @@ -1427,6 +1513,33 @@ USE_MATE= menus:build intlhack</programl <varname>NO_MTREE</varname>, <varname>NO_ARCH</varname>.</para> </sect1> + <sect1 xml:id="uses-mysql"> + <title><literal>mysql</literal></title> + + <para>Possible arguments: (none), + <literal><replaceable>version</replaceable></literal>, + <literal>server</literal>, <literal>embedded</literal></para> + + <para>Provide support for <application>MySQL</application>. If no + version is given, try to find the current installed version. + 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>100m</literal>, and <literal>101m</literal>. The + <literal>m</literal> and <literal>p</literal> suffixes are for + the <application>MariaDB</application> and + <application>Percona</application> variants of + <application>MySQL</application>. <literal>server</literal> and + <literal>embedded</literal> add a build- and run-time dependency + on the <application>MySQL</application> server. A port can set + <varname>IGNORE_WITH_MYSQL</varname> if some versions are not + supported.</para> + + <para>The framework sets <varname>MYSQL_VER</varname> to the + detected MySQL version.</para> + </sect1> + <sect1 xml:id="uses-mono"> <title><literal>mono</literal></title>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201604271355.u3RDtVq5054710>