CVS commit: pkgsrc/bootstrap

["Greg Troxel" <gdt%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   gdt
Date:           Tue Feb 18 23:33:54 UTC 2025

Modified Files:
        pkgsrc/bootstrap: README.macOS

Log Message:
bootstrap/README.macOS: Remove SDK_MAP discussion

because it's gone from the code.

Extend explanation about why one might want to pin the SDK version.

(This commit reapplies a change that was wrongly made to 2024Q4 and
backed out.)


To generate a diff of this commit:
cvs rdiff -u -r1.11 -r1.12 pkgsrc/bootstrap/README.macOS

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

Modified files:

Index: pkgsrc/bootstrap/README.macOS
diff -u pkgsrc/bootstrap/README.macOS:1.11 pkgsrc/bootstrap/README.macOS:1.12
--- pkgsrc/bootstrap/README.macOS:1.11  Mon Mar 11 14:03:57 2024
+++ pkgsrc/bootstrap/README.macOS       Tue Feb 18 23:33:54 2025
@@ -1,4 +1,4 @@
-$NetBSD: README.macOS,v 1.11 2024/03/11 14:03:57 schmonz Exp $
+$NetBSD: README.macOS,v 1.12 2025/02/18 23:33:54 gdt Exp $
 
 Please read the general README file as well.
 
@@ -7,10 +7,12 @@ MNX Cloud. More info: <https://pkgsrc.sm
 
 If these don't suffice for your needs, you'll want to build your own.
 First, install either the full Xcode environment (if that's something
-you want to have) or else just its Command Line Tools. For the latter:
+you want to have) or else just its Command Line Tools.  For the latter:
 
        $ xcode-select --install
 
+While this is often sufficient, see below for dealing with issues.
+
 Next, if you haven't already done so, fetch and extract pkgsrc:
 
        $ curl -O https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc.tar.gz
@@ -31,14 +33,20 @@ Patches to support older systems will ge
 they don't break newer systems and aren't too much trouble to maintain.
 Tigerbrew is a good place to look for such fixes.
 
-Occasionally, after updating to a freshly released macOS version, you'll
-see "No suitable Xcode SDK or Command Line Tools installed." This
-usually means a pkgsrc developer needs to add another `OSX_SDK_MAP`
-entry to `mk/platform/Darwin.mk`.
-
-To target a specific SDK, assuming it's available on your build host,
-set MACOSX_DEPLOYMENT_TARGET during bootstrap. The bootstrap tools and
-all subsequent packages built with those tools will use the specified SDK.
+## XCode
+
+XCode and Command Line Tools are essentially cross compilers, even
+when build host and target are the same, similar to NetBSD's build.sh.
+There are typically multiple "SDKs" for various macOS versions, and
+generally later macOS versions run binaries built for earlier ones.
+For CLT, see /Library/Developer/CommandLineTools/SDKs, and inspect
+defaults with `xcrun`.
+
+New macOS versions usually lead to new XCode versions, and sometimes
+they are troubled.  To choose a specific SDK, set
+MACOSX_DEPLOYMENT_TARGET to [perhaps the SDK version, e.g. 14.2]
+during bootstrap.  The bootstrap tools and all subsequent packages
+built with those tools will use the specified SDK.
 
 -----