From owner-svn-doc-all@freebsd.org Mon Jun 11 11:15:12 2018 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id B52C21014049; Mon, 11 Jun 2018 11:15:12 +0000 (UTC) (envelope-from tobik@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 61DC77E5E2; Mon, 11 Jun 2018 11:15:12 +0000 (UTC) (envelope-from tobik@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 404251AB75; Mon, 11 Jun 2018 11:15:12 +0000 (UTC) (envelope-from tobik@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w5BBFCFD090742; Mon, 11 Jun 2018 11:15:12 GMT (envelope-from tobik@FreeBSD.org) Received: (from tobik@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w5BBFBcL090740; Mon, 11 Jun 2018 11:15:11 GMT (envelope-from tobik@FreeBSD.org) Message-Id: <201806111115.w5BBFBcL090740@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: tobik set sender to tobik@FreeBSD.org using -f From: Tobias Kortkamp Date: Mon, 11 Jun 2018 11:15:11 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r51819 - in head/en_US.ISO8859-1/books/porters-handbook: makefiles special X-SVN-Group: doc-head X-SVN-Commit-Author: tobik X-SVN-Commit-Paths: in head/en_US.ISO8859-1/books/porters-handbook: makefiles special X-SVN-Commit-Revision: 51819 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 11 Jun 2018 11:15:13 -0000 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 installation, and updating of these ports and their packages. - - - <varname>USE_<replaceable>*</replaceable></varname> and - <varname>WANT_<replaceable>*</replaceable></varname> - - USE_* are - set by the port maintainer to define software on which this - port depends. A port that needs Firefox would set - - USE_FIREFOX= yes - - Some USE_* - can accept version numbers or other parameters. For example, - a port that requires Apache 2.2 would set - - USE_APACHE= 22 - - For more control over dependencies in some cases, - WANT_* are - available to more precisely specify what is needed. For - example, consider the mail/squirrelmail port. This - port needs some PHP modules, which are listed in - USE_PHP: - - USE_PHP= session mhash gettext mbstring pcre openssl xml - - Those modules may be available in CLI or web versions, so - the web version is selected with - WANT_*: - - WANT_PHP_WEB= yes - - Available - USE_* and - WANT_* are - defined in the files in - /usr/ports/Mk. - 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 - HAVE_GNOME - Deprecated, do not use. Was used to check if a - component was installed. This was used for ports - that did not have - --enable/--disable - switches for their configure script. But the building - of parts of a port without a implicit request is - discouraged. - - - - WANT_GNOME - Deprecated, do not use. Was used by ports that - needed USE_GNOME for optional - dependencies, which where defined after - bsd.port.pre.mk. Since - USE_GNOME can be used after the - inclusion of bsd.port.options.mk, - there is little need for this macro any more. - - - pangox-compat pangox-compat has been deprecated and split off from the @@ -5386,127 +5364,95 @@ USE_XFCE= libexo libmenu libutil panel - - Using Mozilla + + Using Databases - - Variables for Ports That Use Mozilla + Use one of the USES macros from + to add a dependency + on a database. - - +
+ Database <varname>USES</varname> Macros + + - USE_GECKO - Gecko backend the port can handle. Possible - values: libxul - (libxul.so), - seamonkey - (libgtkembedmoz.so, deprecated, - must not be used any more). + Database + USES Macro + + - USE_FIREFOX - The port requires Firefox as a runtime - dependency. Possible values: yes - (get default version), 40, - 36, 35. Default - dependency is on version - 40. + Berkeley DB + bdb - USE_FIREFOX_BUILD - The port requires Firefox as a buildtime - dependency. Possible values: see USE_FIREFOX. This - automatically sets USE_FIREFOX and assigns the same - value. + MariaDB, MySQL, Percona + mysql - USE_SEAMONKEY - The port requires SeaMonkey as a runtime - dependency. Possible values: yes - (get default version), 20, - 11 (deprecated, must not be used - any more). Default dependency is on version - 20. + PostgreSQL + pgsql - USE_SEAMONKEY_BUILD - The port requires SeaMonkey as a buildtime - dependency. Possible values: see USE_SEAMONKEY. This - automatically sets USE_SEAMONKEY and assigns the same - value. + SQLite + sqlite - - - USE_THUNDERBIRD - The port requires Thunderbird as a runtime - dependency. Possible values: yes - (get default version), 31, - 30 (deprecated, must not be used - any more). Default dependency is on version - 31. - - - - USE_THUNDERBIRD_BUILD - The port requires Thunderbird as a buildtime - dependency. Possible values: see USE_THUNDERBIRD. - This automatically sets USE_THUNDERBIRD and assigns - the same value. -
- A complete list of available variables can be found in - /usr/ports/Mk/bsd.gecko.mk. - + + Using Berkeley DB 6 - - Using Databases + USES= bdb:6 - - Variables for Ports Using Databases + See for more + information. + - - - - Variable - Means - - + + Using MySQL - - - USE_BDB - Obsolete. Replaced by USES=bdb - + When a port needs the MySQL + client library add - - USE_MYSQL - Obsolete. Replaced by USES=mysql - + USES= mysql - - USE_PGSQL - Obsolete. Replaced by USES=pgsql. - + See for more + information. + - - USE_SQLITE - Obsolete. Replaced by USES=sqlite - - - -
+ + Using PostgreSQL + + When a port needs the + PostgreSQL server version 9.6 + or later add + + USES= pgsql:9.6+ +WANT_PGSQL= server + + See for more + information. + + + + Using SQLite 3 + + USES= sqlite:3 + + See for more + information. +