* Added a "macintosh readme" written by Mathew McBride
[citadel.git] / citadel / docs / macintosh-readme.txt
1 Theres only a brief bit on OS X in the docs but to save some people time
2 perhaps this can be noted somewhere:
3
4 All instructions here assume 10.4 (Tiger). Note gcc package difference
5 for earlier versions.
6
7 The easiest way to get Berkeley DB installed is downloading them via
8 Fink ( http://fink.sourceforge.net ). Install db42 via apt-get .
9 Apparently OS X Server installs already have Berkeley DB.
10
11 If you haven't got them already, gcc4.0.pkg, Xcode Tools.mpkg,
12 DeveloperTools.pkg and SDK.pkg from Xcode need to be installed to
13 compile (plain old boring Darwin users should already have all of them).
14 Remember to export CC=gcc-4.0 as gcc isn't symlinked by default.
15
16 libical and webcit install fine, but you need some configure arguments
17 for citadel itself:
18 ./configure --disable-autologin --with-db=/sw/
19 (--disable-autologin must be there otherwise accounts with the same name
20 as system users won't work! I just spent half an hour bashing my head on
21 this!)
22
23 If you didn't grab Berkeley DB from Fink, substitute your own path for
24 --with-db.
25
26 Ignore what the setup script says about Citadel failing to start, start
27 it yourself afterwards.
28
29 I'm not sure if inittab does anything on OS X / Darwin (AFAIK Apple
30 doesn't really want us to use it), so you can create your own startup
31 scripts in /Library/StartupItems/. See
32 http://www.opendarwin.org/en/articles/system_starter_howto/
33
34 Webcit works fine, seems to lock up if you try adding new Internet
35 domains though, add them via the citadel client itself.
36
37 Other than that: Webcit looks better than it was from when I last used
38 it 6 months ago :-)
39
40 - Mathew McBride
41