diff options
author | gdt <gdt@pkgsrc.org> | 2015-11-07 12:55:03 +0000 |
---|---|---|
committer | gdt <gdt@pkgsrc.org> | 2015-11-07 12:55:03 +0000 |
commit | 95a39c5d8fdbe96c581472a460eba90f6859501c (patch) | |
tree | 534ad0d563e79cf3fb656df75876729da2caa030 | |
parent | 1d8b956163e244ad717e77fd8b511a509c7c06a8 (diff) | |
download | pkgsrc-95a39c5d8fdbe96c581472a460eba90f6859501c.tar.gz |
Rototiil versions section
Replace and simplify the versions section. Drop notion of
supported/deprecated. Explain why people run specific old versions.
Assert that there are no 10.4 pkgsrc users, and very few 10.5. Keep
notion that PRs for <= 10.5 without fixes can be closed without
fixing.
Explain Darwin vs OS X. Point to PureDarwin. Explain that pkgsrc for
Darwin is really for OSX and invite doc patches.
Make a few minor edits.
It remains for someone to explain more clearly the issue of
broken/missing SDKs in 10.11 and command line tools.
As discussed on tech-pkg, with input from jperkin and tron.
-rw-r--r-- | bootstrap/README.MacOSX | 101 |
1 files changed, 52 insertions, 49 deletions
diff --git a/bootstrap/README.MacOSX b/bootstrap/README.MacOSX index facb673f7df..b8de9509fa6 100644 --- a/bootstrap/README.MacOSX +++ b/bootstrap/README.MacOSX @@ -1,10 +1,25 @@ -$NetBSD: README.MacOSX,v 1.22 2015/11/06 16:38:27 gdt Exp $ +$NetBSD: README.MacOSX,v 1.23 2015/11/07 12:55:03 gdt Exp $ This file describes the use of current versions of pkgsrc with -multiple versions of OS X, omitting information about previous pkgsrc -versions. (Apple has renamed Mac OS X to OS X, but the filename +multiple versions of Darwin and OS X, omitting information about previous pkgsrc +versions. + +* Darwin vs OS X + +(Apple has renamed Mac OS X to OS X, but the filename remains.) +OS X consists of Darwin (kernel/userland) plus Mac stuff on top. +pkgsrc used to target Darwin, but given the tools issued discussed +below it is not clear that it works on Darwin without OS X. Darwin +from Apple is no longer open source. + +Users of non-OSX Darwin are invited to submit patches to this file. +The only known project is: + http://www.puredarwin.org/ + +Until then, this file remains OSX-centric. + * system tools issues ** native headers vs SDK @@ -24,7 +39,9 @@ pkgsrc defaulted to using gcc. With 10.9, gcc is no longer present. ** i386 vs x86_64 ABI issue -OS X 10.6 and higher supports x86-64 binaries on most Intel Macs. +OS X 10.6 and higher supports x86-64 binaries on Intel Macs with +x86-64 processors, which is now most of them. + This has caused problems with packages which get confused because "MACHINE_ARCH" is in some OS versions set to "i386" (on a 64-bit system!). @@ -35,9 +52,7 @@ system!). On Intel machines, pkgsrc currently defaults to i386 mode (--abi=32) on OS X, and can be set to x86_64 mode (--abi=64). Note that a pkgsrc build in x86_64 mode will not run on an Intel Mac -that is i386 only (some older Mac Minis and Macbooks). For a longer -discussion, see: - +that is i386 only. For a longer discussion, see: http://mail-index.NetBSD.org/pkgsrc-users/2009/09/24/msg010817.html As of 2015-11, changing the default to x86_64 is imminent. @@ -74,58 +89,46 @@ it may be useful to `git clone https://github.com/jsonn/pkgsrc.git`. ** X11 X11 used to be built into OS X, but as of 10.8 it is no longer -included. Install XQuartz from http://xquartz.macosforge.org/landing/ +included. You can install XQuartz from +http://xquartz.macosforge.org/landing/, or try the newly-added pkgsrc +version. * OS X Versions -pkgsrc is a volunteer project, and individuals support/fix packages -and platforms as they choose. However, pkgsrc contributors as a group -share both a bugtracker and norms about what is ok to break and what -is not. To describe these norms, we define levels of concern, keeping -in mind that there are no guarantees: - - SUPPORTED doesn't mean that anyone is required to fix your problem; it - means that we agree that it is broadly desireable that such problems - be fixed and that we therefore allow them to be listed in our issue - tracker. Structural breakage is unacceptable. - - DEPRECATED means that individual problems are not of interest, but - pkgsrc overall working is of enough interest to be allowed to be - listed in the issue tracker. Structural breakage is undesirable, - but a fair topic of discussion if keeping support is painful. - Individual pkg PRs may be bounced to authors to retest with newer - versions, and closed if that doesn't happen in 14 days. - - IGNORED means we are not willing to expend issue tracker resources - (clutter for those reviewing the db) at all. PRs may be summarily - closed. We are also unconcerned with whether pkgsrc works on the - system at all. - -Given the above definitions, the pkgsrc developers label versions of -OS X as follows: +Because Apple drops support for previous hardware faster than the +hardware fails, many machines cannot be upgraded to recent versions of +OS X, creating a greater than usual desire to support old systems. +Because of the particular history of deprecation, most systems tend to +run relatively recent versions or specific older versions (10.6 and +10.5). - 10.11: current. [SUPPORTED] +The stance of pkgsrc is generally to avoid breaking older systems +unless keeping support would cause difficulty, and to accept clean +patches when there is no harm to non-deprecated versions. This +section is partly to document what versions tend to be used and why, +and partly to enable cleaning up bug reports without fixes for very +old systems. - 10.10: recent. [SUPPORTED] +pkgsrc PRs about 10.5 or older that do not contain fixes may be closed +without fixing. - 10.9 (13.4.0): somewhat old but not that crufty. [SUPPORTED] +OS X 10.9 through 10.11 are considered current. - 10.8: old. [SUPPORTED] +There are not any known reasons to run OS X 10.8 instead of upgrading +to a newer version. - 10.7: old. [SUPPORTED] +OS X 10.7 is the last version that works on a few Intel Macs, e.g. the +Mac Pro 1.1 and 2.1 and some Mac Minis. - 10.6 (10.8.0): very old [DEPRECATED] (But note that this is the - Joyent i386-mode build target.) +OS X 10.6 is the last version that works on Intel Macs lacking amd64 +support, e.g. Mac Minis and Macbooks with Core Duo. (There is an +active bulk build for 10.6.) - 10.5 and below: ancient, and PRs will be summarily closed. It is - acceptable to give zero consideration to causing structural - problems on 10.5 and below. [IGNORED] +OS X 10.5 is the last version that works on PowerPC Macs. As of 2015 +reports of using 10.5 are very rare. -Because Apple provides 10.9 as a no-cost upgrade (from 10.6 or higher, -it is fairly likely that 10.6-10.8 will become DEPRECATED faster than -they might have otherwise. (The rationale for supporting versions -beyond the current and previous ones has been the difficulty for users -to upgrade.) +OS X 10.4 is the last version that works on PowerPC G3 and slower G4 +Macs. There have been no recent reports of anyone using pkgsrc on it. * Bulk builds @@ -134,7 +137,7 @@ computers as possible. The main issues are which ABI and which OS X version. Targetting older versions makes a build run on more systems, and targetting newer versions makes the build closer to what would be obtained from bootstrappping on a newer version and thus avoids some -issues. +issues. This section has pointers to active bulk builds. ** 10.6, --abi=32 (i386), gcc |