From b082fc2361ea1738cfbbec9d311653a257f4fb2d Mon Sep 17 00:00:00 2001 From: Pav Lucistnik Date: Thu, 24 Jul 2008 18:49:59 +0000 Subject: [PATCH] - 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 --- .../books/porters-handbook/book.sgml | 112 ++++++++++-------- 1 file changed, 64 insertions(+), 48 deletions(-) diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml index 09534436e2..1cb484f238 100644 --- a/en_US.ISO8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml @@ -3728,10 +3728,13 @@ ${MANPREFIX}/man/de/man3/baz.3.gz These variables are designed to be set by the system administrator. There are many that are standardized in - ports/Mk/bsd.*.mk; 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. + ports/KNOBS + file. + + When creating a port, do not make knob names specific to a + given application. For example in Avahi port, use + WITHOUT_MDNS instead of + WITHOUT_AVAHI_MDNS. You should not assume that a @@ -3750,7 +3753,7 @@ ${MANPREFIX}/man/de/man3/baz.3.gz - The <makevar>WITH_<replaceable>*</replaceable></makevar> + <title>Common <makevar>WITH_<replaceable>*</replaceable></makevar> and <makevar>WITHOUT_<replaceable>*</replaceable></makevar> variables @@ -3764,37 +3767,6 @@ ${MANPREFIX}/man/de/man3/baz.3.gz - - WITH_APACHE2 - - If set, use - www/apache20 - instead of the default of - www/apache13. - - - - WITH_BERKELEY_DB - - Define this variable to specify the ability to - use a variant of the Berkeley database package such as - databases/db41. - An associated variable, - WITH_BDB_VER, may be - set to values such as 2, 3, 4, 41 or 42. - - - - WITH_MYSQL - - Define this variable to specify the ability to - use a variant of the MySQL database package such as - databases/mysql40-server. - An associated variable, - WANT_MYSQL_VER, may be - set to values such as 323, 40, 41, or 50. - - WITHOUT_NLS @@ -3812,19 +3784,9 @@ ${MANPREFIX}/man/de/man3/baz.3.gz WITH_OPENSSL_PORT - Use the version of OpenSSL from + Installs the version of OpenSSL from security/openssl, - overwriting the version that was originally installed - in the base system. - - - - WITH_POSTGRESQL - - Define this variable to specify the ability to - use a variant of the PostGreSQL database package such as - databases/postgresql72. - + even if the base is up to date. @@ -8147,6 +8109,60 @@ CFLAGS+= -DLUA_VERSION_STRING="${VER_STR}" USE_XFCE= mcsmanager configenv + + Using databases + +
+ Variables for ports using databases + + + + + Variable + + Means + + + + + + USE_BDB + + If variable is set to yes, + add dependency on databases/db41 + 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, USE_BDB=42+ will find + the highest installed version, and fall back to 42 if nothing + else is installed. + + + + USE_MYSQL + + If variable is set to yes, add + dependency on databases/mysql50-server + port. An associated variable, + WANT_MYSQL_VER, may be + set to values such as 323, 40, 41, 50 or 51. + + + + USE_PGSQL + + If set to yes, add dependency on + databases/postgresql82 + port. An associated variable, + WANT_PGSQL_VER, may be set to values such + as 73, 74, 80, 81, 82, or 83. + + + + +
+ + + Starting and stopping services (rc scripts)