Attachment 50159 Details for Bug 76472 – book.diff

[patch] book.diff

book.diff (text/plain; charset=us-ascii), 3.01 KB, created by jcamou on 2005-04-20 21:04:34 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: jcamou

Created: 2005-04-20 21:04:34 UTC

Size: 3.01 KB

patch

obsolete

>Index: book.sgml
>===================================================================
>RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
>retrieving revision 1.549
>diff -u -r1.549 book.sgml
>--- book.sgml	3 Apr 2005 08:20:53 -0000	1.549
>+++ book.sgml	20 Apr 2005 19:57:26 -0000
>@@ -3539,6 +3539,84 @@
> 	  </table>
> 
>       </sect2>
>+
>+      <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 will 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
>+	      are allowed.</para>
>+
>+	    <para>When the user runs <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 that file does not 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 will be used when building the port.</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 &lt;bsd.port.pre.mk&gt;
>+
>+.if defined(WITHOUT_FOO)
>+CONFIGURE_ARGS+=	--without-foo
>+.else
>+CONFIGURE_ARGS+=	--witht-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>Brokenness</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>
>+
>     </sect1>
> 
>     <sect1 id="makefile-wrkdir">

Actions: View | Diff

Attachments on bug 76472: 50158 | 50159