</sect2>

      </sect1>

      <sect1 id="makefile-options">

      <title>Makefile Options</title>

      <para>Some large applications can be built in a number of

	configurations, adding functionality if one of a number of

	libraries or applications is available.  Examples include

	choice of natural (human) language, GUI versus command-line,

	or type of database to support.  Since not all users

	want those libraries or applications, the ports system

	provides hooks that the port author can use to control which

	configuration should be built. Supporting these properly will

	make users happy, and effectively provide 2 or more ports for the

	price of one.</para>

        <sect2>

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

	    <makevar>WITHOUT_<replaceable>*</replaceable></makevar></title>

	  <para>These variables are designed to be set by the system

	    administrator.  There are many that are standardized in

	    <filename>ports/Mk/bsd.*.mk</filename>; others are not,

	    which can be confusing.  If you need to add such a

	    configuration variable, please consider using one of the

	    ones from the following list.</para>

	  <note>

	    <para>You should not assume that a

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

	      necessarily has a corresponding

	      <makevar>WITHOUT_<replaceable>*</replaceable></makevar>

	      variable and vice versa.  In general, the default is

	      simply assumed.</para>

	  </note>

	  <note>

	    <para>Unless otherwise specified, these variables are only

	      tested for being set or not set, rather than being set to

	      some kind of variable such as <literal>YES</literal> or

	      <literal>NO</literal>.</para>

	  </note>

	  <table frame="none">

	    <title>The <makevar>WITH_<replaceable>*</replaceable></makevar>

	      and <makevar>WITHOUT_<replaceable>*</replaceable></makevar>

	      variables</title>

	    <tgroup cols="2">

	      <thead>

	        <row>

		  <entry>Variable</entry>

		  <entry>Means</entry>

	        </row>

	      </thead>

	      <tbody>

	        <row>

		  <entry><makevar>WITH_APACHE2</makevar></entry>

		  <entry>If set, use

		    <filename role="package">www/apache2</filename>

		    instead of the default of

		    <filename role="package">www/apache</filename>.</entry>

	        </row>

	        <row>

		  <entry><makevar>WITH_BERKELEY_DB</makevar></entry>

		  <entry>Define this variable to specify the ability to

		    use a variant of the Berkeley database package such as

		    <filename role="package">databases/db41</filename>.

		    An associated variable, 

		    <entry><makevar>WITH_BDB_VER</makevar>, may be

		    set to values such as 2, 3, 4, 41 or 42.</entry>

	        </row>

	        <row>

		  <entry><makevar>WITHOUT_GETTEXT</makevar></entry>

		  <entry>If set, says that internationalization is not

		    needed, which can save compile time.  By default,

		    internalization is used.</entry>

	        </row>

	        <row>

		  <entry><makevar>WITH_MYSQL</makevar></entry>

		  <entry>Define this variable to specify the ability to

		    use a variant of the MySQL database package such as

		    <filename role="package">databases/mysql40-server</filename>.

		    An associated variable, 

		    <entry><makevar>WANT_MYSQL_VER</makevar>, may be

		    set to values such as 323, 40, 41, or 50.</entry>

	        </row>

	        <row>

		  <entry><makevar>WITH_OPENSSL_BASE</makevar></entry>

		  <entry>Use the version of OpenSSL in the base system.</entry>

	        </row>

	        <row>

		  <entry><makevar>WITH_OPENSSL_PORT</makevar></entry>

		  <entry>Use the version of OpenSSL from

		    <filename role="package">security/openssh</filename>,

		    overwriting the version that was originally installed

		    in the base system.</entry>

	        </row>

	        <row>

		  <entry><makevar>WITH_POSTGRESQL</makevar></entry>

		  <entry>Define this variable to specify the ability to

		    use a variant of the PostGreSQL database package such as

		    <filename role="package">databases/postgresql72</filename>.

		    </entry>

	        </row>

	        <row>

		  <entry><makevar>WITHOUT_X11</makevar></entry>

		  <entry>If the port can be built both with and without

		    X support, then it should normally be built with

		    with X support. If this variable is defined, then

		    then the version that does not have X support should

		    be built instead.</entry>

	        </row>

	      </tbody>

	    </tgroup>

	  </table>