CVS commit: pkgsrc/doc

["Taylor R Campbell" <riastradh%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   riastradh
Date:           Fri Apr 12 19:57:06 UTC 2024

Modified Files:
        pkgsrc/doc: HOWTO-use-crosscompile

Log Message:
doc/HOWTO-use-crosscompile: `make USE_CROSS_COMPILE=yes' works now.

At least, it seems to!  Not sure what symptom I saw ages ago when I
warned users against it.


To generate a diff of this commit:
cvs rdiff -u -r1.14 -r1.15 pkgsrc/doc/HOWTO-use-crosscompile

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

Modified files:

Index: pkgsrc/doc/HOWTO-use-crosscompile
diff -u pkgsrc/doc/HOWTO-use-crosscompile:1.14 pkgsrc/doc/HOWTO-use-crosscompile:1.15
--- pkgsrc/doc/HOWTO-use-crosscompile:1.14      Fri Apr 12 19:56:03 2024
+++ pkgsrc/doc/HOWTO-use-crosscompile   Fri Apr 12 19:57:06 2024
@@ -1,7 +1,7 @@
 Cross-compilation in pkgsrc (user's guide)              -*- outline -*-
 Taylor R. Campbell <riastradh%NetBSD.org@localhost>
 
-$NetBSD: HOWTO-use-crosscompile,v 1.14 2024/04/12 19:56:03 riastradh Exp $
+$NetBSD: HOWTO-use-crosscompile,v 1.15 2024/04/12 19:57:06 riastradh Exp $
 
 The following steps enable you to build binary packages for a machine
 architecture other than the one you are building on.  For example, you
@@ -34,15 +34,15 @@ running NetBSD 6.1 on amd64.
 
 In addition to whatever else you want in your mk.conf for pkgsrc, add:
 
-   # Cross-compile by default.
+   # Cross-compile by default.  (Alternatively, you can cross-build
+   # packages with `make package USE_CROSS_COMPILE=no'.)
    #
-   # XXX This currently can't be set to `yes' on the command line,
-   # which is a bug.  But it can be set to `no' to build native
-   # packages.
+   # Note: This must use `?=' so it doesn't override pkgsrc's internal
+   # USE_CROSS_COMPILE=no when recursively building toolchain packages
+   # that have to run on the host.
    USE_CROSS_COMPILE?=  yes
 
-   # Point pkgsrc at the NetBSD tooldir and destdir.  These are used
-   # only for cross-builds.
+   # Point pkgsrc at the NetBSD tooldir and destdir for cross builds.
    TOOLDIR=             /usr/obj/tooldir.NetBSD-6.1-amd64
    CROSS_DESTDIR=       /usr/obj/destdir.evbppc
 
@@ -115,10 +115,6 @@ build a native package, you can run
 
    $ cd /usr/pkgsrc/net/isc-dhcpd4 && make package USE_CROSS_COMPILE=no
 
-XXX Note that currently you cannot omit USE_CROSS_COMPILE?=yes from
-your mk.conf and pass USE_CROSS_COMPILE=yes on the make command line.
-This is a bug.
-
 * Unprivileged notes
 
 I do all this stuff unprivileged in directories under my home