On Sun, 30 Dec 2007 10:49:07 -0500
"D'Arcy J.M. Cain" <darcy@NetBSD.org> 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
     used:</para>


-- 
D'Arcy J.M. Cain <darcy@NetBSD.org>
http://www.NetBSD.org/