From owner-svn-doc-head@FreeBSD.ORG Sun May 11 15:21:55 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 40C2FD3C; Sun, 11 May 2014 15:21:55 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 2D7572B78; Sun, 11 May 2014 15:21:55 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s4BFLt6g032797; Sun, 11 May 2014 15:21:55 GMT (envelope-from rene@svn.freebsd.org) Received: (from rene@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s4BFLtF0032796; Sun, 11 May 2014 15:21:55 GMT (envelope-from rene@svn.freebsd.org) Message-Id: <201405111521.s4BFLtF0032796@svn.freebsd.org> From: Rene Ladan Date: Sun, 11 May 2014 15:21:55 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44808 - head/en_US.ISO8859-1/books/porters-handbook/makefiles X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 11 May 2014 15:21:55 -0000 Author: rene Date: Sun May 11 15:21:54 2014 New Revision: 44808 URL: http://svnweb.freebsd.org/changeset/doc/44808 Log: Remove a section on WITH_ and WITHOUT_ knobs. The text referred to ^/KNOBS in the Ports repository which has been removed for a while. The options framework should be used instead. Prodded by: Barnerd on #bsddocs Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/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 Sat May 10 11:44:24 2014 (r44807) +++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Sun May 11 15:21:54 2014 (r44808) @@ -3447,95 +3447,6 @@ MASTERDIR= ${.CURDIR}/../xdvi300 options properly will make users happy, and effectively provide two or more ports for the price of one. - - Knobs - - - <varname>WITH_<replaceable>*</replaceable></varname> - and - <varname>WITHOUT_<replaceable>*</replaceable></varname> - - These variables are designed to be set by the system - administrator. There are many that are standardized in the - 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 - WITH_* - necessarily has a corresponding - WITHOUT_* - variable and vice versa. In general, the default is - simply assumed. - - - - Unless otherwise specified, these variables are only - tested for being set or not set, rather than being set to - a specific value such as YES or - NO. - - - - Common - <varname>WITH_<replaceable>*</replaceable></varname> and - <varname>WITHOUT_<replaceable>*</replaceable></varname> - Variables - - - - - Variable - Means - - - - - - WITH_OPENSSL_BASE - Use the version of OpenSSL in the base - system. - - - - WITH_OPENSSL_PORT - Installs the version of OpenSSL from - security/openssl, - even if the base is up to date. - - - -
- - - - Knob Naming - - Porters should use like-named knobs, both for the - benefit of end-users and to help keep the number of knob - names down. A list of popular knob names can be found in - the KNOBS - file. - - Knob names should reflect what the knob is and does. - When a port has a lib-prefix in the - PORTNAME the lib-prefix should be - dropped in knob naming. - - - Knob names should be always be in all - uppercase. - - - - <varname>OPTIONS</varname>