Fixup fromcvs/togit conversion
[pkgsrcv2.git] / bootstrap / README.MacOSX
1 $NetBSD: README.MacOSX,v 1.13 2012/12/29 20:02:38 wiz Exp $
2
3
4 Mac OS X Snow Leopard 32/64 (i386/x86_64) ABI issue:
5
6 Mac OS X Snow Leopard (10.6) supports 64-bit binaries on most Intel
7 Macs and builds those by default on such machine.  This causes
8 problems with a lot of packages which get confused because
9 "MACHINE_ARCH" is set to "i386" (on a 64-bit system!).  There are also
10 packages that don't support 64-bit under Mac OS X at all.  Because of
11 this, the default for pkgsrc is use use the 32-bit ABI, which results
12 in packages being compiled and run in i386 mode.  For a longer
13 discussion, see:
14 http://mail-index.NetBSD.org/pkgsrc-users/2009/09/24/msg010817.html
15
16
17 Developer tools:
18
19 If you haven't already, you will need to install the Mac OS X Developer
20 Tools package. Depending on the version of OS X you are running, you
21 may have this on CD. If not, you can download it from Apple's
22 Developer Connection. (You will need to register for a free ADC
23 account.) See http://developer.apple.com/macosx/ for details.
24 (If you don't want or need the full Xcode GUI, download and install
25 Command Line Tools for Xcode.)
26
27 Then start Xcode, go to "Preferences" - "Downloads" and install
28 the "Command Line Tools".
29
30 If you plan to build packages that use the X11 Window System, you
31 will also need to make sure you have an Xserver installed. Download
32 XQuartz from http://xquartz.macosforge.org/landing/
33
34 Experimental support for IBM's XL C/C++ compiler is present (tested
35 with version 6.0). To use it, set:
36
37 PKGSRC_COMPILER=xlc
38
39 in mk.conf. XL C uses the Apple provided libtool to create shared
40 libraries, however, we must force it to call libtool with the full
41 path to avoid calling the pkgsrc provided GNU libtool with arguments
42 that it does not understand.
43
44 edit the template configuration file /opt/ibmcmp/vac/6.0/etc/vac.base.cfg
45 and set:
46
47 libtool = /usr/bin/libtool
48
49 then run:
50
51 /opt/ibmcmp/vacpp/6.0/bin/vacpp_configure -gcc /usr -install -force
52
53 as root to install the configuration.
54
55 to bootstrap with xlc, you need to make sure CFLAGS contains "-ma":
56
57 env CC=/opt/ibmcmp/vacpp/6.0/bin/xlc CFLAGS=-ma ./bootstrap
58
59
60 Mac OS X Versions
61
62 pkgsrc is a volunteer project, and individuals support/fix packages
63 and platforms as they choose.  However, pkgsrc contributors as a group
64 share both a bugtracker and norms about what is ok to break and what
65 is not.  To describe these norms, we define levels of concern, keeping
66 in mind that there are no guarantees:
67
68   SUPPORTED doesn't mean that anyone is required to fix your problem; it
69   means that we agree that it is broadly desireable that such problems
70   be fixed and that we therefore allow them to be listed in our issue
71   tracker.
72
73   DEPRECATED means that individual problems are not of interest, but
74   pkgsrc overall working is of enough interest to be allowed to be
75   listed in the issue tracker.
76
77   IGNORED means we are not willing to expend issue tracker resources
78   (clutter for those reviewing the db) at all.
79
80 Given the above definitions, the pkgsrc developers label versions of
81 Mac OS X as follows:
82
83   10.8: current, PRs may be filed.  Structurally breaking pkgsrc on 10.8
84         is considered not ok.  [SUPPORTED]
85
86   10.7: old, but PRs may still be filed.  Structurally breaking pkgsrc on
87         10.7 is considered not ok. [SUPPORTED]
88
89   10.6: very old, and individual pkg PRs may be bounced to authors to
90         retest with newer versions, and closed if that doesn't happen
91         in 14 days.  We will for now consider structurally breaking
92         pkgsrc on 10.6 to be undesirable.  If keeping support for 10.6
93         causes excessive work for maintainers it may be moved to
94         IGNORED state any time, without warning. [DEPRECATED]
95
96   10.5 and below: ancient, and PRs will be summarily closed.  It is
97         acceptable to give zero consideration to causing structural
98         problems on 10.5 and below. [IGNORED]