CVS commit: pkgsrc/doc/guide/files

["Sevan Janiyan" <sevan%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   sevan
Date:           Fri Jan  6 20:26:40 UTC 2017

Modified Files:
        pkgsrc/doc/guide/files: buildlink.xml

Log Message:
Instruct the reader to set prefer-pkgsrc during bootstrap. It appears that
setting this post bootstrap does create issues, as observed with a Linux user
today.


To generate a diff of this commit:
cvs rdiff -u -r1.39 -r1.40 pkgsrc/doc/guide/files/buildlink.xml

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/doc/guide/files/buildlink.xml
diff -u pkgsrc/doc/guide/files/buildlink.xml:1.39 pkgsrc/doc/guide/files/buildlink.xml:1.40
--- pkgsrc/doc/guide/files/buildlink.xml:1.39   Sun Jul 10 07:46:29 2016
+++ pkgsrc/doc/guide/files/buildlink.xml        Fri Jan  6 20:26:39 2017
@@ -1,4 +1,4 @@
-<!-- $NetBSD: buildlink.xml,v 1.39 2016/07/10 07:46:29 rillig Exp $ -->
+<!-- $NetBSD: buildlink.xml,v 1.40 2017/01/06 20:26:39 sevan Exp $ -->
 
 <chapter id="buildlink">
   <title>Buildlink methodology</title>
@@ -587,6 +587,17 @@ PREFER_NATIVE=  getopt skey tcp_wrappers
       <filename>builtin.mk</filename>
       file to be listed in <varname>PREFER_NATIVE</varname>,
       otherwise it is simply ignored in that list.</para>
+
+      <para>Setting <varname>PREFER_NATIVE</varname> should be performed
+      straight after bootstrap and <varname>PREFER_PKGSRC</varname> during
+      bootstrap.
+      Switching between settings globally at a later date can introduce
+      complications with dependency resolution. This is caused by packages
+      built with the opposite preference being installed alongside each other.</para>
+      
+<screen>
+&rprompt; <userinput>./bootstrap --prefer-pkgsrc yes</userinput>
+</screen>
     </sect2>
   </sect1>
 </chapter>