Subject: Re: PKG_OPTIONS handling not clearly documented
To: None <>
From: D'Arcy J.M. Cain <>
List: tech-pkg
Date: 12/30/2007 11:10:22
On Sun, 30 Dec 2007 10:49:07 -0500
"D'Arcy J.M. Cain" <> wrote:
> says that but it is definitely not intuitive.  I may look at the docs
> to see if I can make it clearer.

Note change to subject from "PKG_OPTIONS not properly handled."

How is this?

Index: pkgsrc/doc/guide/files/configuring.xml
RCS file: /cvsroot/pkgsrc/doc/guide/files/configuring.xml,v
retrieving revision 1.30
diff -u -p -u -r1.30 configuring.xml
--- pkgsrc/doc/guide/files/configuring.xml      17 Oct 2007 14:08:02
-0000     1.30 +++ pkgsrc/doc/guide/files/configuring.xml      30 Dec
2007 16:05:58 -0000 @@ -361,6 +361,11 @@ PKG_DEFAULT_OPTIONS=    -arts
-dvdread - PKG_OPTIONS.kdebase=    debug -sasl
 PKG_OPTIONS.apache=     suexec </screen>
+    <para>It is important to note that options that were specifically
+    suggested by the package maintainer must be explicitely removed if
+    you do not wish to include the option.  If you are unsure you can view
+    the current state with <command>make show-options</command>.</para>
     <para>The following settings are consulted in the order given, and
     the last setting that selects or disables an option is

D'Arcy J.M. Cain <>