Sat Sep 23 05:53:53 2017 UTC ()
Rename OS X to macOS to follow Apple's new naming

Eric Brown: PR pkg/52567: Readme.MacOSX is out of date

Additional changes by me: don't mention that the file isn't README.OSX
due to OS X being a different name, because the new name macOS makes
the filename less confusing.


(maya)
diff -r1.34 -r1.35 pkgsrc/bootstrap/README.MacOSX
cvs diff -r1.34 -r1.35 pkgsrc/bootstrap/Attic/README.MacOSX (expand / switch to unified diff)

--- pkgsrc/bootstrap/Attic/README.MacOSX 2017/09/21 19:42:16 1.34
+++ pkgsrc/bootstrap/Attic/README.MacOSX 2017/09/23 05:53:52 1.35
@@ -1,47 +1,44 @@ @@ -1,47 +1,44 @@
1$NetBSD: README.MacOSX,v 1.34 2017/09/21 19:42:16 gdt Exp $ 1$NetBSD: README.MacOSX,v 1.35 2017/09/23 05:53:52 maya Exp $
2 2
3This file describes the use of current versions of pkgsrc with 3This file describes the use of current versions of pkgsrc with
4multiple versions of Darwin and OS X, omitting information about previous pkgsrc 4multiple versions of Darwin and macOS, omitting information about
5versions. 5previous pkgsrc versions.
6 6
7* Darwin vs OS X 7* Darwin vs macOS
8 8
9(Apple has renamed Mac OS X to OS X, but the filename 9macOS consists of Darwin (kernel/userland) plus Mac stuff on top.
10remains.) 
11 
12OS X consists of Darwin (kernel/userland) plus Mac stuff on top. 
13pkgsrc used to target Darwin, but given the tools issued discussed 10pkgsrc used to target Darwin, but given the tools issued discussed
14below it is not clear that it works on Darwin without OS X. Darwin 11below it is not clear that it works on Darwin without macOS. Darwin
15from Apple is no longer open source. 12from Apple is no longer open source.
16 13
17Users of non-OS X Darwin are invited to submit patches to this file. 14Users of non-macOS Darwin are invited to submit patches to this file.
18The only known project is: 15The only known project is:
19 http://www.puredarwin.org/ 16 http://www.puredarwin.org/
20 17
21Until then, this file remains OS X-centric. 18Until then, this file remains macOS-centric.
22 19
23* OS X specific bootstrap arguments 20* macOS specific bootstrap arguments
24 21
25Providing the --binary-macpkg flag to the bootstrap script causes it 22Providing the --binary-macpkg flag to the bootstrap script causes it
26to prepare a bootstrap kit as a native OS X package instead of using 23to prepare a bootstrap kit as a native macOS package instead of using
27the conventional .tar.bz2 format. This requires the package-maker 24the conventional .tar.bz2 format. This requires the package-maker
28application to be installed. 25application to be installed.
29 26
30* system tools issues 27* system tools issues
31 28
32** native headers vs SDK 29** native headers vs SDK
33 30
34OS X used to include system headers in /usr/include, so that one 31macOS used to include system headers in /usr/include, so that one
35could treat it like a relatively normal POSIX system. Starting at 32could treat it like a relatively normal POSIX system. Starting at
36approximately 10.9, headers were no longer available at the standard 33approximately 10.9, headers were no longer available at the standard
37location, and one has to use an SDK that puts headers someplace else. 34location, and one has to use an SDK that puts headers someplace else.
38pkgsrc supports this, but there has been some confusion where a 10.9 35pkgsrc supports this, but there has been some confusion where a 10.9
39system produced binaries for 10.10, which only mostly works. The 36system produced binaries for 10.10, which only mostly works. The
40confusion is believed to be resolved. 37confusion is believed to be resolved.
41 38
42** gcc vs clang 39** gcc vs clang
43 40
44Older versions of OS X (when XCode is installed) provided gcc, and 41Older versions of OS X (when XCode is installed) provided gcc, and
45pkgsrc defaulted to using gcc. With 10.9, gcc is no longer present. 42pkgsrc defaulted to using gcc. With 10.9, gcc is no longer present.
46 43
47** i386 vs x86_64 ABI issue 44** i386 vs x86_64 ABI issue
@@ -107,107 +104,108 @@ option. Repeatable data about recovery  @@ -107,107 +104,108 @@ option. Repeatable data about recovery
107most are past this issue already and no longer interested in 104most are past this issue already and no longer interested in
108experimenting.) 105experimenting.)
109 106
110** sed in 10.9 107** sed in 10.9
111 108
112The sed that comes with 10.9 appears to be broken; it exits when 109The sed that comes with 10.9 appears to be broken; it exits when
113called on files with UTF-8 or other apparently-binary content. 110called on files with UTF-8 or other apparently-binary content.
114Therefore, pkgsrc uses nbsed on 10.9. 111Therefore, pkgsrc uses nbsed on 10.9.
115 112
116* Developer tools and prerequisites 113* Developer tools and prerequisites
117 114
118** XCode 115** XCode
119 116
120This section applies to 10.6 through 10.12. 117This section applies to 10.6 through 10.13.
121 118
122If you haven't already, you will need to install the OS X 119If you haven't already, you will need to install the macOS
123Developer Tools package (XCode) to obtain a compiler, etc. The 120Developer Tools package (XCode) to obtain a compiler, etc. The
124procedure depends on the version of OS X; recent versions use the 121procedure depends on the version of macOS; recent versions use the
125App Store. 122App Store.
126 123
127*** Command-line Tools 124*** Command-line Tools
128 125
129XCode 9 (the current version), even when installed on OS X 10.12, does 126XCode 9 (the current version) does not include an SDK for 10.12. If
130not include an SDK for 10.12. If one installs "Commmand Line Tools", 127one installs "Commmand Line Tools", then pkgsrc can use the compiler.
131then pkgsrc can use the compiler. 
132 128
133Since Xcode 7 (installed from the Apple Store) the development 129Since Xcode 7 (installed from the Apple Store) the development
134environment can upgrade itself without interaction from the user, but 130environment can upgrade itself without interaction from the user, but
135will not automatically update the Command Line Tools. This will 131will not automatically update the Command Line Tools. This will
136cause system header files like stdlib.h not to be found by pkgsrc. 132cause system header files like stdlib.h not to be found by pkgsrc.
137The command `xcode-select --install' will install the Command Line 133The command `xcode-select --install' will install the Command Line
138Tools for Xcode. 134Tools for Xcode.
139 135
140In the past at least, Command Line Tools for Xcode could be obtained 136In the past at least, Command Line Tools for Xcode could be obtained
141from https://developer.apple.com/downloads/ 137from https://developer.apple.com/downloads/
142 138
143** cvs 139** cvs
144 140
145Note that as of 10.9, cvs is no longer provided by Apple. You can build 141Note that as of 10.9, cvs is no longer provided by Apple. You can build
146devel/scmcvs. To obtain pkgsrc in order to bootstrap and build cvs, 142devel/scmcvs. To obtain pkgsrc in order to bootstrap and build cvs,
147it may be useful to `git clone https://github.com/jsonn/pkgsrc.git`. 143it may be useful to `git clone https://github.com/NetBSD/pkgsrc.git`.
148 144
149** X11 145** X11
150 146
151X11 used to be built into OS X, but as of 10.8 it is no longer 147X11 used to be built into macOS, but as of 10.8 it is no longer
152included. You can install XQuartz from 148included. You can install XQuartz from
153https://www.xquartz.org, or try the newly-added pkgsrc 149https://www.xquartz.org, or try the newly-added pkgsrc
154version. 150version.
155 151
156* OS X Versions 152* macOS Versions
157 153
158Because Apple drops support for previous hardware faster than the 154Because Apple drops support for previous hardware faster than the
159hardware fails, many machines cannot be upgraded to recent versions of 155hardware fails, many machines cannot be upgraded to recent versions of
160OS X, creating a greater than usual desire to support old systems. 156macOS, creating a greater than usual desire to support old systems.
161Because of the particular history of deprecation, most systems tend to 157Because of the particular history of deprecation, most systems tend to
162run relatively recent versions or specific older versions (10.6 and 158run relatively recent versions or specific older versions (10.6 and
16310.5). 15910.5).
164 160
165The stance of pkgsrc is generally to avoid breaking older systems 161The stance of pkgsrc is generally to avoid breaking older systems
166unless keeping support would cause difficulty, and to accept clean 162unless keeping support would cause difficulty, and to accept clean
167patches when there is no harm to non-deprecated versions. This 163patches when there is no harm to non-deprecated versions. This
168section is partly to document what versions tend to be used and why, 164section is partly to document what versions tend to be used and why,
169and partly to enable cleaning up bug reports without fixes for very 165and partly to enable cleaning up bug reports without fixes for very
170old systems. 166old systems.
171 167
172pkgsrc PRs about 10.5 or older that do not contain fixes may be closed 168pkgsrc PRs about 10.5 or older that do not contain fixes may be closed
173without fixing. 169without fixing.
174 170
175OS X 10.11 is considered new and there may be issues. 171macOS 10.12 - 10.13 are considered new and there may be issues.
 172
 173OS X 10.11 is considered new and there may be issues.
176 174
177OS X 10.10 is considered current. 175OS X 10.10 is considered current.
178 176
179OS X 10.9 (Darwin 13.4.0) is considered current. 177OS X 10.9 (Darwin 13.4.0) is considered current.
180 178
181OS X 10.8 is old, and there are no no known reasons to it instead of a 179OS X 10.8 is old, and there are no no known reasons to it instead of a
182newer version. 180newer version.
183 181
184OS X 10.7 is the last version that works on a few Intel Macs, e.g. the 182OS X 10.7 is the last version that works on a few Intel Macs, e.g. the
185Mac Pro 1.1 and 2.1 and some Mac Minis. 183Mac Pro 1.1 and 2.1 and some Mac Minis.
186 184
187OS X 10.6 is the last version that works on Intel Macs lacking amd64 185OS X 10.6 is the last version that works on Intel Macs lacking amd64
188support, e.g. Mac Minis and Macbooks with Core Duo. (There is an 186support, e.g. Mac Minis and Macbooks with Core Duo. (There is an
189active bulk build for 10.6.) 187active bulk build for 10.6.)
190 188
191OS X 10.5 is the last version that works on PowerPC Macs. As of 2015 189OS X 10.5 is the last version that works on PowerPC Macs. As of 2015
192reports of using 10.5 are very rare. 190reports of using 10.5 are very rare.
193 191
194OS X 10.4 (Darwin 8.11.0) is the last version that works on PowerPC G3 192OS X 10.4 (Darwin 8.11.0) is the last version that works on PowerPC G3
195and slower G4 Macs. 193and slower G4 Macs.
196 194
197* Bulk builds 195* Bulk builds
198 196
199Clearly, it is desirable for a bulk build to be useful on as many 197Clearly, it is desirable for a bulk build to be useful on as many
200computers as possible. The main issues are which ABI and which OS X 198computers as possible. The main issues are which ABI and which macOS
201version. Targeting older versions makes a build run on more systems, 199version. Targeting older versions makes a build run on more systems,
202and targeting newer versions makes the build closer to what would be 200and targeting newer versions makes the build closer to what would be
203obtained from bootstrapping on a newer version and thus avoids some 201obtained from bootstrapping on a newer version and thus avoids some
204issues. This section has pointers to active bulk builds. 202issues. This section has pointers to active bulk builds.
205 203
206** 10.4, --abi=32 powerpc, gcc 204** 10.4, --abi=32 powerpc, gcc
207 205
208Sevan Janiyan <Sevan@NetBSD.org> provides a bulk build for the -current branch 206Sevan Janiyan <Sevan@NetBSD.org> provides a bulk build for the -current branch
209(--abi=32, OS X 10.4/PowerPC, gcc 4.0.1 from Xcode 2.5, X11_TYPE=modular): 207(--abi=32, OS X 10.4/PowerPC, gcc 4.0.1 from Xcode 2.5, X11_TYPE=modular):
210 https://www.geeklan.co.uk/?p=1579 208 https://www.geeklan.co.uk/?p=1579
211 US repo: http://sevan.mit.edu/packages 209 US repo: http://sevan.mit.edu/packages
212 Euro mirror: http://pkgsrc.geeklan.co.uk/packages/current/Darwin-8 210 Euro mirror: http://pkgsrc.geeklan.co.uk/packages/current/Darwin-8
213 See 211 See