From owner-freebsd-ports@FreeBSD.ORG Sun Jun 3 18:44:51 2012 Return-Path: Delivered-To: ports@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 4AE04106566B for ; Sun, 3 Jun 2012 18:44:51 +0000 (UTC) (envelope-from bapt@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 17BD88FC08 for ; Sun, 3 Jun 2012 18:44:51 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q53IiocD014785 for ; Sun, 3 Jun 2012 18:44:50 GMT (envelope-from bapt@FreeBSD.org) Received: (from bapt@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q53IiotM014784 for ports@FreeBSD.org; Sun, 3 Jun 2012 18:44:50 GMT (envelope-from bapt@FreeBSD.org) X-Authentication-Warning: freefall.freebsd.org: bapt set sender to bapt@FreeBSD.org using -f Date: Sun, 3 Jun 2012 20:44:48 +0200 From: Baptiste Daroussin To: ports@FreeBSD.org Message-ID: <20120603184448.GI92976@ithaqua.etoilebsd.net> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="6b3yLyRKT1M6kiA0" Content-Disposition: inline User-Agent: Mutt/1.5.21 (2010-09-15) Cc: Subject: [HEADSUP] Please convert your ports to new options framework X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 03 Jun 2012 18:44:51 -0000 --6b3yLyRKT1M6kiA0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Hi, The new options framework is now in the port for a week, most of the problems directly concerning the framework seems to have been addressed. Some issue seems still to be there regarding backward compatibility but I haven't been able to reproduced any of the one that are supposed to be left. The porters handbook has been updated and the new option framework is well documented (thank you crees) Please convert as soon as possible your ports to the new framework. As you may already have notice bsd.options.desc.mk provide shared descriptions of the usual options, try to be consistent and reuse the same options name so that it is simpler for users, please override the description for your ports each time it make sense, remember that most of the time a functional description is more accurate than a technical one, users might not know the technical details but they know what functionnality they do want. All the complaints I found in the past concerning the old framework have been addressed in the new one, you can have mutually exclusive options, checked by the framework, you can have group options, you can have 0 or only 1 option among N or 0 or N options among M. be creative, most of the use case should be doable. for 3 special options: DOCS, EXAMPLES and NLS, you do not need to activate them in OPTIONS_DEFAULT as the framework already activate them. you also do not need to add them to OPTIONS_DEFINE if you only use one of them, do avoid having the dialog UI to show up. DOCS in long term maybe used to replace NOPORTDOCS (NOPORTDOCS is defined has a backward compatibility if as a user you remove it). Same goes for EXAMPLES -> NOPORTEXAMPLES and NLS -> WITHOUT_NLS In my concern the priority is: 1/ convert all the old OPTIONS: Here is a list of them http://wiki.freebsd.org/Ports/Options/ConvertingToOptionsNG 2/ replace all the knobs by optionsNg options (replacing the KNOBS file by bsd.options.desc regards, Bapt --6b3yLyRKT1M6kiA0 Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.19 (FreeBSD) iEYEARECAAYFAk/LsKAACgkQ8kTtMUmk6ExjKACgv6velDPQXFaH8mMJ2f/OcCfC M1MAoK8mNoSScHl5ThVsc0b9NKvZB8sc =i15J -----END PGP SIGNATURE----- --6b3yLyRKT1M6kiA0--