- Overhaul Makefile options section, and split USE_* flags into their own Using

databases section under chapter 6.

PR:		docs/125907 (based on)
Submitted by:	tabthorpe
This commit is contained in:
Pav Lucistnik 2008-07-24 18:49:59 +00:00
parent bf1ce11401
commit b082fc2361
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=32578

View file

@ -3728,10 +3728,13 @@ ${MANPREFIX}/man/de/man3/baz.3.gz</programlisting>
<para>These variables are designed to be set by the system
administrator. There are many that are standardized in
<filename>ports/Mk/bsd.*.mk</filename>; others are not,
which can be confusing. If you need to add such a
configuration variable, please consider using one of the
ones from the following list.</para>
<ulink url="http://www.freebsd.org/cgi/cvsweb.cgi/ports/KNOBS?rev=HEAD&amp;content-type=text/x-cvsweb-markup"><filename>ports/KNOBS</filename></ulink>
file.</para>
<para>When creating a port, do not make knob names specific to a
given application. For example in Avahi port, use
<makevar>WITHOUT_MDNS</makevar> instead of
<makevar>WITHOUT_AVAHI_MDNS</makevar>.</para>
<note>
<para>You should not assume that a
@ -3750,7 +3753,7 @@ ${MANPREFIX}/man/de/man3/baz.3.gz</programlisting>
</note>
<table frame="none">
<title>The <makevar>WITH_<replaceable>*</replaceable></makevar>
<title>Common <makevar>WITH_<replaceable>*</replaceable></makevar>
and <makevar>WITHOUT_<replaceable>*</replaceable></makevar>
variables</title>
@ -3764,37 +3767,6 @@ ${MANPREFIX}/man/de/man3/baz.3.gz</programlisting>
</thead>
<tbody>
<row>
<entry><makevar>WITH_APACHE2</makevar></entry>
<entry>If set, use
<filename role="package">www/apache20</filename>
instead of the default of
<filename role="package">www/apache13</filename>.</entry>
</row>
<row>
<entry><makevar>WITH_BERKELEY_DB</makevar></entry>
<entry>Define this variable to specify the ability to
use a variant of the Berkeley database package such as
<filename role="package">databases/db41</filename>.
An associated variable,
<makevar>WITH_BDB_VER</makevar>, may be
set to values such as 2, 3, 4, 41 or 42.</entry>
</row>
<row>
<entry><makevar>WITH_MYSQL</makevar></entry>
<entry>Define this variable to specify the ability to
use a variant of the MySQL database package such as
<filename role="package">databases/mysql40-server</filename>.
An associated variable,
<makevar>WANT_MYSQL_VER</makevar>, may be
set to values such as 323, 40, 41, or 50.</entry>
</row>
<row id="knobs-without-nls">
<entry><makevar>WITHOUT_NLS</makevar></entry>
@ -3812,19 +3784,9 @@ ${MANPREFIX}/man/de/man3/baz.3.gz</programlisting>
<row>
<entry><makevar>WITH_OPENSSL_PORT</makevar></entry>
<entry>Use the version of OpenSSL from
<entry>Installs the version of OpenSSL from
<filename role="package">security/openssl</filename>,
overwriting the version that was originally installed
in the base system.</entry>
</row>
<row>
<entry><makevar>WITH_POSTGRESQL</makevar></entry>
<entry>Define this variable to specify the ability to
use a variant of the PostGreSQL database package such as
<filename role="package">databases/postgresql72</filename>.
</entry>
even if the base is up to date.</entry>
</row>
<row>
@ -8147,6 +8109,60 @@ CFLAGS+= -DLUA_VERSION_STRING="${VER_STR}"
<programlisting>USE_XFCE= mcsmanager configenv</programlisting>
</sect1>
<sect1 id="using-databases">
<title>Using databases</title>
<table frame="none">
<title>Variables for ports using databases</title>
<tgroup cols="2">
<thead>
<row>
<entry>Variable</entry>
<entry>Means</entry>
</row>
</thead>
<tbody>
<row>
<entry><makevar>USE_BDB</makevar></entry>
<entry>If variable is set to <literal>yes</literal>,
add dependency on <filename role="package">databases/db41</filename>
port. The variable may also be set to values: 2, 3, 40, 41,
42, 43, 44, 45 46, or 47. You can declare a range of
acceptable values, <makevar>USE_BDB</makevar>=42+ will find
the highest installed version, and fall back to 42 if nothing
else is installed.</entry>
</row>
<row>
<entry><makevar>USE_MYSQL</makevar></entry>
<entry>If variable is set to <literal>yes</literal>, add
dependency on <filename role="package">databases/mysql50-server</filename>
port. An associated variable,
<makevar>WANT_MYSQL_VER</makevar>, may be
set to values such as 323, 40, 41, 50 or 51.</entry>
</row>
<row>
<entry><makevar>USE_PGSQL</makevar></entry>
<entry>If set to <literal>yes</literal>, add dependency on
<filename role="package">databases/postgresql82</filename>
port. An associated variable,
<makevar>WANT_PGSQL_VER</makevar>, may be set to values such
as 73, 74, 80, 81, 82, or 83.</entry>
</row>
</tbody>
</tgroup>
</table>
</sect1>
<sect1 id="rc-scripts">
<title>Starting and stopping services (rc scripts)</title>