<sect2>

	<title><makevar>OPTIONS</makevar></title>

	<sect3>

	  <title>Background</title>

	    <para>The <makevar>OPTIONS</makevar> variable gives the user who

	    installs the port a dialog with the available options and saves

	    them to <filename>/var/db/ports/portname/options</filename>. Next

	    time when the port has to be rebuild, the options are reused. Never

	    again you have to remember all the twenty

	    <makevar>WITH_<replaceable>*</replaceable></makevar> and

	    <makevar>WITHOUT_<replaceable>*</replaceable></makevar> options you

	    used to build this port!</para>

	</sect3>

	<sect3>

	  <title>Syntax</title>

	  <para>The syntax for the <makevar>OPTIONS</makevar> variable is:

<programlisting>OPTIONS=	option	"descriptive text" default ...

</programlisting>

	  The value for default is either <literal>ON</literal> or

	  <literal>OFF</literal>. Multiple repetitions of these three fields

	  is allowed.</para>

	  <para>When the user runs the <command>make config</command> (or runs

	  <command>make build</command> for the first time), the framework will

	  check for

	  <filename>/var/db/ports/<replaceable>portname</replaceable>/options</filename>.

	  If it doesn't exist, it will use the values of

	  <makevar>OPTIONS</makevar> to create a dialogbox where the options

	  can be enabled or disabled. Then the options file is saved and the

	  selected variables are set.</para>

	  <para>Use <command>make showconfig</command> to see the saved

	  configuration. Use <command>make rmconfig</command> to remove the saved

	  configuration.</para>

	<sect3>

	  <title>Example</title>

	  <example id="ports-options-simple-use">

	    <title>Simple use of <makevar>OPTIONS</makevar></title>

	    <para><programlisting>OPTIONS=	foo "Enable option foo" On \

			bar "Support feature bar" Off

.include <bsd.port.pre.mk>

.if defined(WITH_FOO)

CONFIGURE_ARGS+=	--with-foo

.else

CONFIGURE_ARGS+=	--without-foo

.endif

.if defined(WITH_BAR)

RUN_DEPENDS+=	bar:${PORTSDIR}/bar/bar

.endif

.include &lt;bsd.port.post.mk&gt;</programlisting></para>

	  </example>

	<sect3>

	  <title>Brokeness</title>

	  <itemizedlist>

	    <listitem>

	      <para><command>make index</command> doesn't follow

	      <makevar>OPTIONS</makevar> yet (ports/75727)</para>

	    </listitem>

	    <listitem>

	      <para><makevar>PACKAGE_BUILDING</makevar> is ignoring

	      <makevar>OPTIONS</makevar> (ports/75727?)</para>

	    </listitem>

	  </itemizedlist>

	</sect3>

      </sect2>