CVS commit: [pkgsrc-2024Q4] pkgsrc/bootstrap

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

Module Name:    pkgsrc
Committed By:   gdt
Date:           Sun Jan 12 01:24:37 UTC 2025

Modified Files:
        pkgsrc/bootstrap [pkgsrc-2024Q4]: README.macOS

Log Message:
bootstrap/README.macOS: Add section headings

This is arguably less pretty, but I think it's a lot easier  to
absorb, since it's a collection of advice for multiple unrelated
concerns.

Lead with building from source, as users compiling packages is
doctrinally the standard approach even though binary packages are
chosen by many.

CVS: ----------------------------------------------------------------------
CVS: CVSROOT  cvs.NetBSD.org:/cvsroot
CVS: please use "PR category/123" to have the commitmsg appended to PR 123


To generate a diff of this commit:
cvs rdiff -u -r1.11.8.1 -r1.11.8.2 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.8.1 pkgsrc/bootstrap/README.macOS:1.11.8.2
--- pkgsrc/bootstrap/README.macOS:1.11.8.1      Sun Jan 12 01:19:02 2025
+++ pkgsrc/bootstrap/README.macOS       Sun Jan 12 01:24:37 2025
@@ -1,17 +1,16 @@
-$NetBSD: README.macOS,v 1.11.8.1 2025/01/12 01:19:02 gdt Exp $
+$NetBSD: README.macOS,v 1.11.8.2 2025/01/12 01:24:37 gdt Exp $
 
 Please read the general README file as well.
 
-Binary packages are available for macOS arm64 and x86_64, provided by
-MNX Cloud. More info: <https://pkgsrc.smartos.org/install-on-macos/>
+# Building from source
 
-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:
 
        $ xcode-select --install
 
-While this is often sufficient, see below for dealing with issues.
+While this is often sufficient, see the XCode section below for
+dealing with issues.
 
 Next, if you haven't already done so, fetch and extract pkgsrc:
 
@@ -24,8 +23,17 @@ Once bootstrapped, install `devel/scmcvs
 anonymous CVS. Alternatively, swap out your CVS checkout for a clone
 from this git mirror: <https://github.com/NetBSD/pkgsrc/>
 
+# Binary packages
+
+Binary packages are available for macOS arm64 and x86_64, provided by
+MNX Cloud. More info: <https://pkgsrc.smartos.org/install-on-macos/>
+
+# Hints for operating on macOS
+
 For a local X11 display server, install `x11/modular-xorg-xquartz`.
 
+# Hints for fixing packages
+
 For any particular package that doesn't build, macOS fixes are often in
 MacPorts or Homebrew waiting to be borrowed.
 
@@ -33,7 +41,7 @@ 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.
 
-## XCode
+# 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.