mirror of
https://github.com/gnustep/tools-make.git
synced 2025-04-23 22:33:28 +00:00
README.Darwin minor improvements
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/tools/make/trunk@18771 72102866-910b-0410-8b05-ffd578937521
This commit is contained in:
Quentin Mathe
parent
3db2dec0be
commit
d3a0bf412e
2 changed files with 80 additions and 93 deletions
|
|
@ -1,3 +1,7 @@
|
|||
2004-03-4 Quentin Mathe <qmathe@club-internet.fr>
|
||||
|
||||
* Documentation/README.Darwin: Minor improvements.
|
||||
|
||||
Thu Mar 4 13:06:22 2004 Nicola Pero <n.pero@mi.flashnet.it>
|
||||
|
||||
* Instance/framework.make (xxx_DEPLOY_WITH_CURRENT_VERSION):
|
||||
|
|
@ -41,7 +45,7 @@ Thu Mar 4 10:41:21 2004 Nicola Pero <n.pero@mi.flashnet.it>
|
|||
2004-02-28 Quentin Mathe <qmathe@club-internet.fr>
|
||||
|
||||
* Documentation/README.Darwin: Update with the detailed and
|
||||
complete installation process on Mac OS X and Darwin (with the
|
||||
complete installation process on Mac OS X And Darwin (with the
|
||||
help of Nicolas Roard).
|
||||
|
||||
2004-02-23 Adam Fedor <fedor@gnu.org>
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
Date : 15-Jan-2004
|
||||
Last update: 26-Feb-2004 (tested under Mac OS X 10.3 / Darwin 7)
|
||||
Last update: 4-Mar-2004 (tested under Mac OS X 10.3 / Darwin 7)
|
||||
--> must be verified on x86-darwin-7, powerpc-apple-darwin-6
|
||||
Authors: Adam Fedor <fedor@gnu.org>
|
||||
Quentin Mathé <qmathe@club-internet.fr>
|
||||
|
|
@ -18,8 +18,7 @@ COMMONLY USED SYMBOLS
|
|||
---------------------
|
||||
|
||||
<> denotes a variable depending on your preferences. To be replaced with the
|
||||
actual values from
|
||||
your system. For instance, if you installed gcc in /opt/local
|
||||
actual values from your system. For instance, if you installed gcc in /opt/local
|
||||
|
||||
./configure CC='<gcc install dir>/bin/gcc'
|
||||
|
||||
|
|
@ -43,11 +42,12 @@ POTENTIAL ERRORS WHEN RUNNING MAKE ESPECIALLY WITH BACK AND GUI
|
|||
---------------------------------------------------------------
|
||||
|
||||
If you get errors like below, just do:
|
||||
make clean
|
||||
make
|
||||
The second or the third time, the errors should disappear.
|
||||
It's probably due to some potential issues between FSF GCC and the libtool/ld
|
||||
Mac OS X / Darwin
|
||||
|
||||
make clean
|
||||
make
|
||||
|
||||
The second or the third time, the errors should disappear. It's probably due to
|
||||
some potential issues between FSF GCC and the libtool/ld Mac OS X / Darwin
|
||||
versions.
|
||||
|
||||
Linking subproject x11 ...
|
||||
|
|
@ -72,9 +72,8 @@ libpng (Optional, highly recommended)
|
|||
libffi (Required, only contained in the gcc distributions and pyobjc)
|
||||
ffcall (On Darwin x86 - use instead of libffi)
|
||||
|
||||
Xfree86 (Required, already in Mac OS X 10.3/Darwin 7, to know more read below,
|
||||
needed for 10.2 /
|
||||
Darwin 6 and earlier)
|
||||
Xfree86 (Required, already in Mac OS X 10.3/Darwin 7, to know more read below,
|
||||
needed for 10.2 / Darwin 6 and earlier)
|
||||
|
||||
libart2 (Optional, but required in the case you choose to use the art backend)
|
||||
freetype2 (Optional, but required in the case you choose to use the art backend)
|
||||
|
|
@ -85,10 +84,9 @@ Obtaining GNUstep
|
|||
-----------------
|
||||
|
||||
The main GNUstep project pages tell you how to get hold of this. You can get the
|
||||
latest release of
|
||||
the following libraries. However, since Mac OS X support is currently evolving,
|
||||
we recommend that
|
||||
you get the latest snapshot or code from CVS.
|
||||
latest release of the following libraries. However, since Mac OS X support is
|
||||
currently evolving, we recommend that you get the latest snapshot or code from
|
||||
CVS.
|
||||
|
||||
You need these gnustep packages:
|
||||
|
||||
|
|
@ -99,10 +97,10 @@ GNUstep-back
|
|||
|
||||
Targets
|
||||
-------
|
||||
|
||||
For GNUstep, there are several combinations of Objective-C runtime, Foundation
|
||||
library and
|
||||
Application Kit library possible, called library combos.
|
||||
The usual notation is:
|
||||
library and Application Kit library possible, called library combos. The usual
|
||||
notation is:
|
||||
|
||||
objcruntime-foundation-applicationkit
|
||||
|
||||
|
|
@ -127,11 +125,11 @@ Apple GCC, gnu-gnu-gnu
|
|||
FSF GCC, gnu-gnu-gnu
|
||||
|
||||
Unfortunately, using Apple GCC with gnu-gnu-gnu doesn't appear to work currently
|
||||
(see below for more info), so this option really isn't open now.
|
||||
(see below for more info), so this option really isn't open now.
|
||||
|
||||
In addition, if you are on Mac OS X, you can also use the Apple Foundation and
|
||||
AppKit
|
||||
frameworks to do GNUstep development with Cocoa, but this only works with the
|
||||
Apple compiler:
|
||||
AppKit frameworks to do GNUstep development with Cocoa, but this only works with
|
||||
the Apple compiler:
|
||||
|
||||
Apple GCC, apple-apple-apple
|
||||
|
||||
|
|
@ -139,14 +137,11 @@ GNUstep on Darwin x86
|
|||
---------------------
|
||||
|
||||
For GNUstep on Darwin x86, Apple GCC compiles GNUstep-base, but causes strange
|
||||
problems when
|
||||
running programs (e.g. the program hangs while allocating memory or executes
|
||||
methods multiple
|
||||
times). So we have to use FSF GCC.
|
||||
problems when running programs (e.g. the program hangs while allocating memory
|
||||
or executes methods multiple times). So we have to use FSF GCC.
|
||||
|
||||
Additionally, libffi has not been ported to Darwin x86, so you will need to
|
||||
install ffcall
|
||||
instead.
|
||||
install ffcall instead.
|
||||
|
||||
ffcall (ftp://ftp.gnustep.org/pub/gnustep/libs or
|
||||
ftp://ftp.santafe.edu/pub/gnu/ffcall-1.9.tar.gz)
|
||||
|
|
@ -157,11 +152,9 @@ GNUstep on Darwin PowerPC
|
|||
-------------------------
|
||||
|
||||
Haven't been able to get Apple GCC on Mac OS X 10.2 / Darwin 6 to compile
|
||||
GNUstep-base.
|
||||
The compiler crashes with various errors.
|
||||
You need the FSF GCC compiler here. You need at least version 3.3.2. (While
|
||||
version
|
||||
3.3.2 works, it will not install libffi)
|
||||
GNUstep-base. The compiler crashes with various errors. You need the FSF GCC
|
||||
compiler here. You need at least version 3.3.2. (While version 3.3.2 works, it
|
||||
will not install libffi)
|
||||
|
||||
Building FSF-GCC
|
||||
----------------
|
||||
|
|
@ -219,14 +212,14 @@ else use [CC='<gcc install dir>/bin/gcc'] when running configure.
|
|||
|
||||
then:
|
||||
|
||||
./configure --with-library-combo=gnu-gnu-gnu [--prefix=<GNUstep install dir>]
|
||||
./configure --with-library-combo=gnu-gnu-gnu [--prefix=<GNUstep install dir>]
|
||||
[CC='<gcc install dir>/bin/gcc']
|
||||
|
||||
(apple-apple-apple is the default if you don't specify gnu-gnu-gnu). If you
|
||||
want to be able to compile for different targets/platforms together. Do this:
|
||||
(apple-apple-apple is the default if you don't specify gnu-gnu-gnu). If you want
|
||||
to be able to compile for different targets/platforms together. Do this:
|
||||
|
||||
./configure --with-library-combo=gnu-gnu-gnu -disable-flattened
|
||||
--enable-multi-platform [--prefix=<GNUstep install dir>] [CC='<gcc install
|
||||
--enable-multi-platform [--prefix=<GNUstep install dir>] [CC='<gcc install
|
||||
dir>/bin/gcc']
|
||||
|
||||
Now:
|
||||
|
|
@ -239,7 +232,7 @@ Building and installing libobjc (target Apple GCC, gnu-gnu-gnu only !!!)
|
|||
|
||||
Warning ! Don't compile libobjc if you are using FSF GCC.
|
||||
|
||||
Go to gnustep-objc (or from CVS, into dev-libs/libobjc), and type
|
||||
Go to gnustep-objc (or from CVS, into dev-libs/libobjc), and type:
|
||||
|
||||
make install
|
||||
|
||||
|
|
@ -249,12 +242,11 @@ Building and installing libffi (on Darwin PowerPC only !!!)
|
|||
------------------------------
|
||||
|
||||
Untar the GNU gcc distribution, at least a version 3.4 series snapshot (even if
|
||||
you are not
|
||||
compiling the compiler) and:
|
||||
you are not compiling the compiler) and:
|
||||
|
||||
mkdir libffi-build
|
||||
cd libffi-build
|
||||
<gcc-3.4 install dir>/libffi/configure
|
||||
<gcc-3.4 install dir>/libffi/configure [CC='<gcc install dir>/bin/gcc']
|
||||
make
|
||||
make install
|
||||
|
||||
|
|
@ -262,8 +254,7 @@ Note: the lastest 3.4 snapshot doesn't seem to have a working libffi on Mac OS X
|
|||
/ Darwin.
|
||||
|
||||
Use PyObjC libffi from http://pyobjc.sourceforge.net, in the case GNUstep-base
|
||||
install doesn't
|
||||
work with the 3.4 snapshot.
|
||||
install doesn't work with the 3.4 snapshot.
|
||||
|
||||
mkdir libffi-build
|
||||
cd libffi-build
|
||||
|
|
@ -271,8 +262,8 @@ cd libffi-build
|
|||
make
|
||||
make install
|
||||
|
||||
Warning !
|
||||
Don't install libffi in <gcc install dir>, let it just install in /usr/local.
|
||||
Warning ! Don't install libffi in <gcc install dir>, let it just install in
|
||||
/usr/local.
|
||||
|
||||
Building and installing ffcall (on Darwin x86 only !!!)
|
||||
------------------------------
|
||||
|
|
@ -289,15 +280,14 @@ Now you can now build and install it simply by typing:
|
|||
Additional libraries
|
||||
--------------------
|
||||
|
||||
Build and install and additional libraries listed above. You can also
|
||||
get them via Fink (http://fink.sourceforge.net) or DarwinPorts
|
||||
Build and install and additional libraries listed above. You can also get them
|
||||
via Fink (http://fink.sourceforge.net) or DarwinPorts
|
||||
(http://darwinports.opendarwin.org/) and sometimes they are already present on
|
||||
Mac OS X.
|
||||
|
||||
And to have the additional libraries taken in account by the Mac OS X / Darwin
|
||||
linker with bourne
|
||||
shell like bash (Mac OS X 10.3), here is an example with Fink obtained
|
||||
libraries:
|
||||
linker with bourne shell like bash (Mac OS X 10.3), here is an example with Fink
|
||||
obtained libraries:
|
||||
|
||||
echo 'export DYLD_LIBRARY_PATH=<gcc install dir>/lib:/sw/lib:$DYLD_LIBRARY_PATH'
|
||||
>> ~/.profile
|
||||
|
|
@ -327,9 +317,9 @@ If you are using the default gcc (Apple GCC) type:
|
|||
|
||||
make install
|
||||
|
||||
This should automatically run the configure script for you, build the
|
||||
base library and some tools, and install the whole lot (along with some
|
||||
system resources).
|
||||
This should automatically run the configure script for you, build the base
|
||||
library and some tools, and install the whole lot (along with some system
|
||||
resources).
|
||||
|
||||
Otherwise (if you installed FSF GCC) type:
|
||||
|
||||
|
|
@ -344,10 +334,10 @@ followed by
|
|||
make
|
||||
make install
|
||||
|
||||
On the apple-apple-apple target, it will only build the GNUstep
|
||||
additions library that adds extra stuff to Foundation. If you are
|
||||
using the apple-apple-apple target, there currently is no reason to
|
||||
go on and compile GNUstep-gui.
|
||||
On the apple-apple-apple target, it will only build the GNUstep additions
|
||||
library that adds extra stuff to Foundation. If you are using the
|
||||
apple-apple-apple target, there currently is no reason to go on and compile
|
||||
GNUstep-gui.
|
||||
|
||||
Building and installing GNUstep-gui
|
||||
-----------------------------------
|
||||
|
|
@ -366,8 +356,7 @@ followed by
|
|||
Note: The gsnd server hasn't been ported to Mac OS X / Darwin yet.
|
||||
|
||||
In the case configure didn't found libjpeg, use --with-jpeg-library=<jpeg lib
|
||||
dir>
|
||||
--with-jpeg-include=<jpeg include dir> to have the libjpeg detected.
|
||||
dir> --with-jpeg-include=<jpeg include dir> to have the libjpeg detected.
|
||||
|
||||
Example with Fink:
|
||||
|
||||
|
|
@ -378,10 +367,13 @@ Example with Fink:
|
|||
Building and installing GNUstep-back
|
||||
------------------------------------
|
||||
|
||||
Warning !
|
||||
You must have installed X11User.pkg from the Panther install disc and also
|
||||
X11SDK.pkg from the
|
||||
xCode Tools install disc to be able to compile GNUstep-back.
|
||||
Warning ! You must have installed X11User.pkg from the Panther install disc and
|
||||
also X11SDK.pkg from the xCode Tools install disc to be able to compile
|
||||
GNUstep-back under Mac OS X 10.3.
|
||||
|
||||
If you aren't installing GNUstep under Mac OS X 10.3 / Darwin 7, you can use
|
||||
XDarwin (ftp://ftp.xfree86.org/pub/XFree86/4.3.0/binaries/Darwin-ppc-6.x/) for
|
||||
the X server, take a look at http://www.xdarwin.org
|
||||
|
||||
In the back directory, type:
|
||||
|
||||
|
|
@ -390,10 +382,8 @@ In the back directory, type:
|
|||
make install
|
||||
|
||||
In the case, you choose to use the art backend, you will need to have the
|
||||
freetype2 and libart2
|
||||
libraries installed, first be sure to have libart2 in your path, for example,
|
||||
with Fink
|
||||
installation type:
|
||||
freetype2 and libart2 libraries installed, first be sure to have libart2 in your
|
||||
path, for example, with Fink installation type:
|
||||
|
||||
export DYLD_LIBRARY_PATH=/sw/lib:$DYLD_LIBRARY_PATH
|
||||
|
||||
|
|
@ -403,21 +393,18 @@ Then you should be able to configure back and install it.
|
|||
make
|
||||
make install
|
||||
|
||||
You also need to have /sw/lib in your library path before running
|
||||
GNUstep apps with the art backend, as it needs to find libart2, so put the
|
||||
above export DYLD_LIBRARY_PATH somewhere in your .profile (or do the export
|
||||
before launching an application) [see the above "Additional Libraries" section].
|
||||
You also need to have /sw/lib in your library path before running GNUstep apps
|
||||
with the art backend, as it needs to find libart2, so put the above export
|
||||
DYLD_LIBRARY_PATH somewhere in your .profile (or do the export before launching
|
||||
an application) [see the above "Additional Libraries" section].
|
||||
|
||||
The backend architecture which GNUstep-gui is built upon, has been written to be
|
||||
used within X
|
||||
Windows, then you need to start up an X Server (like Apple X11) to run the
|
||||
GNUstep-gui
|
||||
applications.
|
||||
used within X Windows, then you need to start up an X Server (like Apple X11) to
|
||||
run the GNUstep-gui applications.
|
||||
|
||||
Warning !
|
||||
With the art backend, before to launch applications based on GNUstep-gui, in the
|
||||
shell, don't
|
||||
forget to edit the defaults (no need it to redo it later) :
|
||||
Warning ! With the art backend, before to launch applications based on
|
||||
GNUstep-gui, in the shell, don't forget to edit the defaults (no need it to redo
|
||||
it later) :
|
||||
|
||||
defaults write NSGlobalDomain XWindowBufferUseXShm NO
|
||||
|
||||
|
|
@ -428,22 +415,19 @@ More informations on the art backend
|
|||
------------------------------------
|
||||
|
||||
To have a working art backend... You will also need to download and install
|
||||
fonts, as it uses a
|
||||
specific font format. Use for example the file
|
||||
fonts, as it uses a specific font format. Use for example the file
|
||||
http://w1.423.telia.com/~u42308495/alex/backart/ArtResources-0.1.2.tar.bz2 and
|
||||
put the .nfont
|
||||
directories somewhere in $(GNUSTEP_SYSTEM_ROOT)/Library/Fonts
|
||||
put the .nfont directories somewhere in $(GNUSTEP_SYSTEM_ROOT)/Library/Fonts
|
||||
|
||||
Other fonts are available on http://www.knuddel.org/Downloads/Fonts/
|
||||
|
||||
Window Maker
|
||||
------------
|
||||
|
||||
Window Maker is the standard window manager for GNUstep.
|
||||
Window Maker is the traditionnal window manager for GNUstep.
|
||||
|
||||
In the case, you choose to use it, don't forget to execute wmaker.inst else
|
||||
Window Maker will
|
||||
crash with signal 10.
|
||||
Window Maker will crash with signal 10.
|
||||
|
||||
Example with Fink, do:
|
||||
/sw/bin/wmaker.inst
|
||||
|
|
@ -454,13 +438,12 @@ GNUstep daemons
|
|||
Refer to GNUstep-HOWTO to know how to launch GNUstep daemons.
|
||||
|
||||
Note: If you try to start GNUstep daemons by hand with 'sudo opentool dameon',
|
||||
it won't work,
|
||||
because when you become root on Mac OS X / Darwin with sudo or su,
|
||||
DYLD_LIBRARY_PATH environment
|
||||
variable is erased, then to start them in the shell, do:
|
||||
it won't work, because when you become root on Mac OS X / Darwin with sudo or
|
||||
su, DYLD_LIBRARY_PATH environment variable is erased, then to start them in the
|
||||
shell, do:
|
||||
|
||||
sudo opentool gdomap (gdomap doesn't rely on the GNUstep libraries or other
|
||||
special librairies)
|
||||
special librairies)
|
||||
su root
|
||||
|
||||
then with bourne shell like bash (Mac OS X 10.3):
|
||||
|
|
@ -478,4 +461,4 @@ opentool gpbs
|
|||
|
||||
---
|
||||
|
||||
That's all.
|
||||
That's all.
|
||||
Loading…
Reference in a new issue