Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 3 Jun 2012 20:44:48 +0200
From:      Baptiste Daroussin <bapt@FreeBSD.org>
To:        ports@FreeBSD.org
Subject:   [HEADSUP] Please convert your ports to new options framework
Message-ID:  <20120603184448.GI92976@ithaqua.etoilebsd.net>

next in thread | raw e-mail | index | archive | help

--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--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20120603184448.GI92976>