gnustep/tools-make
0
0
Fork 0
mirror of https://github.com/gnustep/tools-make.git synced 2025-04-23 22:33:28 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Rewritten the base library install instructions in README.Darwin

Browse source 
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/tools/make/trunk@20488 72102866-910b-0410-8b05-ffd578937521
This commit is contained in:
Quentin Mathe 2004-12-27 14:15:21 +00:00
parent 6797e3ebdc
commit 2b0492c0d1
4 changed files with 120 additions and 74 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
ChangeLog
View file

@ -1,3 +1,13 @@
2004-12-27 Quentin Mathe <qmathe@club-internet.fr>
* Documentation/README.Darwin: Rewritten the base library install
instructions (libxslt support with Fink explained) and other minor
updates.
* Documentation/machines.texi: Made the GNUstep on MacOSX section a bit
more clear.
* GNUstep-HOWTO: Synchronized with Documentation/machines.texi and made
the spacing more consistent.
2004-12-26 Quentin Mathe <qmathe@club-internet.fr>
* Documentation/README.Darwin: Updated to take in account the latest

74
Documentation/README.Darwin
View file

@ -1,5 +1,5 @@
Date : 15-Jan-2004
Last update: 20041225 (tested under Mac OS X 10.3 / Darwin 7)
Last update: 20041227 (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>
@ -19,7 +19,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
@ -61,7 +61,7 @@ see an instruction like 'make install', you usually need to use sudo
libjpeg (Optional, highly recommended)
libpng (Optional, highly recommended)
libffi (Required, only contained in the gcc distributions and pyobjc)
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)
@ -135,8 +135,8 @@ 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.
Version 3.3.5 seems to cause the fewest headaches, but later versions 3.4.x
doesn't work on Mac OS X / Darwin (because libobjc cannot be compiled, the
related gcc bug report is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11572).
don't work on Mac OS X / Darwin (because libobjc cannot be compiled, the
related GCC bug report is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11572).
Building FSF-GCC
----------------
@ -149,7 +149,7 @@ FSF GCC is difficult to compile here. The only way I could do it was like this:
# x86 but not necessary
# on OpenDarwin 7.2.1
and then configure gcc with:
and then configure GCC with:
mkdir build # Create a sibling to the
# toplevel source dir
@ -164,7 +164,7 @@ and then configure gcc with:
(Replace X.X.X with the actual distribution you have).
gcc on Darwin doesn't appear to support threads.
GCC on Darwin doesn't appear to support threads.
Darwin PowerPC:
@ -175,11 +175,11 @@ Configure and build as follows (tested using gcc-3.3.2 on Mac OS X 10.2 and
cd build
<dir>/gcc-x.x.x/configure \ # The first option
[--prefix=<gcc install dir>] \ # permits to change the
[--enable-languages=c,objc] # fact gcc installs by
[--enable-languages=c,objc] # fact GCC installs by
# default in /usr/local
# The second option
# permits to speed the
# gcc compilation in the
# GCC compilation in the
# case you will not use
# languages other than c
# and objc
@ -233,7 +233,7 @@ This should build and install the GNU Objective-C runtime and headers for you.
Building and installing libffi (on Darwin PowerPC only !!!)
------------------------------
Untar the GNU gcc distribution, at least a version 3.4.x (even if you are not
Untar the GNU GCC distribution, at least a version 3.4.x (even if you are not
compiling the compiler) and:
mkdir libffi-build
@ -245,7 +245,7 @@ compiling the compiler) and:
Note: some 3.4.x versions doesn't have a working libffi on Mac OS X / Darwin.
Use PyObjC libffi from http://pyobjc.sourceforge.net, in the case libffi
install doesn't work with the 3.4.x version.
(This libffi issue needs to be tested with the various gcc 3.4.x versions)
(This libffi issue needs to be tested with the various GCC 3.4.x versions)
mkdir libffi-build
cd libffi-build
@ -284,23 +284,45 @@ Building and installing GNUstep-base
Go to GNUstep-base (or from CVS into the core/base directory).
If you are using the default gcc (Apple GCC) type:
Note: If you are using .
If you are using the FSF GCC (with the Apple GCC which only works currently
with the apple-apple-apple library combo, you don't need to run the configure
yourself unless you need special options), type:
./configure [--with-xml-prefix=/usr] [--disable-xmltest] [--disable-do] \
[LDFLAGS=-L/sw/lib] [CPPFLAGS=-I/sw/include] [CC=<gcc install dir>/bin/gcc]
To know which options you need to use with your environment:
--disable-xmltest is needed with the latest Mac OS X 10.3 / Darwin 7
versions xml2-config tool and libxml2 headers reports differents versions,
because of this versions conflict the GNUstep xmltest fails.
--with-xml-prefix=/usr is needed with Mac OS X 10.3 / Darwin 7 when you
want to build the base library with xslt support and you have installed
libxslt with Fink (because Fink installs lixml2 without the headers when
you install lixslt, and by default the base library tries to link Fink
libxml2 first, then the configuration fails because configure looks for
the libxml2 headers).
--disable-do is needed when you decide to not build libffi or ffcall.
LDFLAGS=-L/sw/lib is needed when you installed libxslt with Fink and you
want to compile the base library with libxslt support.
CPPFLAGS=-I/sw/include is needed when you installed libxslt with Fink and
you want to compile the base library with libxslt support.
followed when you are using the Apple GCC by:
make install
Note: this should automatically run the configure script for you (in the case
you haven't done it).
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:
./configure [CC=<gcc install dir>/bin/gcc]
or if you decided not to build libffi or ffcall:
./configure --disable-do [CC=<gcc install dir>/bin/gcc]
followed by:
otherwise (with the FSF GCC) followed by:
make
make install
@ -315,7 +337,7 @@ Building and installing GNUstep-gui
Go to GNUstep-gui (or from CVS into the core/gui directory).
If you are using the Apple GCC or the FSF GCC type:
If you are using the Apple GCC (doesn't work currently) or the FSF GCC type:
./configure --disable-gsnd [CC=<gcc install dir>/bin/gcc]

27
Documentation/machines.texi
View file

@ -111,11 +111,11 @@ Currently tested on Darwin 7.x
@item Recommended compiler
gcc 3.3.2 or greater 3.3.* versions.
Older versions will not compile on Darwin and 3.4.* versions don't
support GNU runtime compilation on Darwin currently (The gcc bug report
support GNU runtime compilation on Darwin currently (The GCC bug report
is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11572).
Default compiler (Apple gcc) has unknown problems.
Download the FSF gcc compiler and configure it with
Default compiler (Apple GCC) has unknown problems.
Download the FSF GCC compiler and configure it with
-enable-threads=posix. You don't need binutils or anything else.
Use the GNU runtime.
@ -146,11 +146,11 @@ Currently tested on Darwin 6.x, 7.x
@item Recommended compiler
gcc 3.3.2 or greater 3.3.* versions.
Older versions will not compile on Darwin and 3.4.* versions don't
support GNU runtime compilation on Darwin currently (The gcc bug report
support GNU runtime compilation on Darwin currently (The GCC bug report
is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11572).
Default compiler (Apple gcc) has unknown problems.
Download the FSF gcc compiler and configure it with
Default compiler (Apple GCC) has unknown problems.
Download the FSF GCC compiler and configure it with
-enable-threads=posix. You don't need binutils or anything else.
Use the GNU runtime.
@ -382,11 +382,16 @@ Default. For 10.1.5, you need to add -no-cpp-precomp to CFLAGS
@item Extra libs needed
None.
@item Special Instructions
By default, on Mac OS X, only the GNUstep extensions are built. This
is if you want to build gdl2, etc on Mac OS X. Xcode project files
exist, but they may not be up-to-date. Make sure /usr/sbin is in your
path:
@item Special Instructions
Warning ! To know how to install a complete GNUstep system on Mac OS X,
read the Darwin/PowerPC section.
By default, on Mac OS X, only the GNUstep extensions are built. Read the @url{README.Darwin} file in the gnustep-make/Documentation directory for
complete instructions.
To build the GNUstep extensions only is useful, when you want to build
on Mac OS X, GNUstep related projects like gdl2, etc linked to Cocoa.
Xcode project files exist, but they may not be up-to-date. Make sure
/usr/sbin is in your path:
@example
PATH=$PATH:/usr/sbin

83
GNUstep-HOWTO
View file

@ -1,7 +1,7 @@
GNUstep HOWTO
*************
Last Update: 3 September 2004
Last Update: 25 December 2004
This document explains how to build the different components of the
GNUstep core libraries and GNUstep Launchpad.
@ -396,11 +396,11 @@ Currently tested on Darwin 7.x
`Recommended compiler'
gcc 3.3.2 or greater 3.3.* versions
Older versions will not compile on Darwin and 3.4.* versions don't
support GNU runtime compilation on Darwin currently (The gcc bug
support GNU runtime compilation on Darwin currently (The GCC bug
report is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11572).
Default compiler (Apple gcc) has unknown problems.
Download the FSF gcc compiler and configure it with
Default compiler (Apple GCC) has unknown problems.
Download the FSF GCC compiler and configure it with
--enable-threads=posix. You don't need binutils or anything else.
Use the GNU runtime.
@ -411,7 +411,6 @@ Currently tested on Darwin 7.x
Read the <README.Darwin> file in the gnustep-make/Documentation
directory for complete instructions.
Darwin/PowerPC
==============
@ -420,11 +419,11 @@ Currently tested on Darwin 6.x, 7.x
`Recommended compiler'
gcc 3.3.2 or greater 3.3.* versions
Older versions will not compile on Darwin and 3.4.* versions don't
support GNU runtime compilation on Darwin currently (The gcc bug
support GNU runtime compilation on Darwin currently (The GCC bug
report is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11572).
Default compiler (Apple gcc) has unknown problems.
Download the FSF gcc compiler and configure it with
Default compiler (Apple GCC) has unknown problems.
Download the FSF GCC compiler and configure it with
--enable-threads=posix. You don't need binutils or anything else.
Use the GNU runtime.
@ -438,8 +437,7 @@ Currently tested on Darwin 6.x, 7.x
Read the <README.Darwin> file in the gnustep-make/Documentation
directory for complete instructions.
See also the MacOSX/PowerPC section
See also the MacOSX/PowerPC section
Debian/DEC-Alpha
================
@ -457,6 +455,7 @@ Debian/i386
===========
Tested on sid.
`Recommended compiler'
Unknown
@ -470,6 +469,7 @@ Debian/PowerPC
==============
Tested on sid.
`Recommended compiler'
Unknown
@ -483,6 +483,7 @@ Debian/SPARC
============
Tested on sid.
`Recommended compiler'
Unknown
@ -505,8 +506,7 @@ Tested on 5.0 and 5.1
Can install via /usr/ports/devel/gnustep, but not all required
dependancies are installed. See the GNUstep-HOWTO for list of
libraries.
FreeBSD 4.x
===========
@ -520,7 +520,6 @@ FreeBSD 4.x
For libxml2 2.4.24, make WITHOUT_PYTHON=YES
FreeBSD 3.x
===========
@ -555,14 +554,13 @@ Compiles "out of the box" on FreeBSD 3.4.
This can be done more much easily by using the port version. Just
`cd' to `/usr/ports/lang/egcs' and do a `"make WANT_THREADS=yes
install"'. Easy.
install"'. Easy.
If configure cannot find tiff.h or the tiff library and you have
it installed in a non-standard place (even `/usr/local'), you may
need to pass these flags to configure:
`CFLAGS="-I/usr/local/include"' and `LDFLAGS="-L/usr/local/lib"'.
FreeBSD 2.x (_Obsolete,Unstable_)
=================================
@ -584,7 +582,6 @@ FreeBSD 2.x (_Obsolete,Unstable_)
FreeBSD 3.x. You need to use gmake not make to compile the
GNUstep packages.
Irix 6.5/MIPS
=============
@ -605,23 +602,40 @@ Irix 6.5/MIPS
use systune ncargs to increase the value (maximum is 262144) or
link the library by hand. No libffi-support: Use ffcall
MacOSX/PowerPC
==============
Currently tested on MacOSX 10.2, 10.3
This section is for building the GNUstep extensions only.
Use this if, for instance, if you want to build something based
on GNUstep, such as GSWeb or GNUMail. If you want to build the complete
GNUstep system independant of Mac OS X, see the Darwin/PowerPC section.
Currently tested on MacOSX 10.1.5, 10.2, 10.3
`Recommended compiler'
Default.
Default. For 10.1.5, you need to add -no-cpp-precomp to CFLAGS
(For instance, ./configure CFLAGS="-no-cpp-precomp" ...)
`Extra libs needed'
None.
`Special Instructions'
By default, on Mac OS X, only the GNUstep extensions are built.
This is if you want to build gdl2, etc on Mac OS X. Xcode project
files exist, but they may not be up-to-date. Try:
Warning! To know how to install a complete GNUstep system on
Mac OS X, read the Darwin/PowerPC section.
By default, on Mac OS X, only the GNUstep extensions are built.
Read the <README.Darwin> file in the
gnustep-make/Documentation directory for complete instructions.
To build the GNUstep extensions only is useful, when you want to
build on Mac OS X, GNUstep related projects like gdl2, etc linked
to Cocoa. Xcode project files exist, but they may not be
up-to-date. Make sure /usr/sbin is in your path:
PATH=$PATH:/usr/sbin
Then type:
cd make
./configure --with-library-combo=apple-apple-apple
make install
@ -629,7 +643,9 @@ Currently tested on MacOSX 10.2, 10.3
cd ../base
./configure --with-xml-prefix=/usr --disable-xmltest
make debug=yes install
On Mac OS X 10.1.5, there is no libxml. Either install libxml2
or configure base with --disable-xml.
See also the Darwin/PowerPC section.
@ -648,7 +664,6 @@ Tested with R2 RC2 (2004/03/04).
`Special Instructions'
Unknown.
NetBSD
======
@ -661,7 +676,6 @@ NetBSD
`Special Instructions'
See the <README.NetBSD> file located in the gnustep-make package.
Netwinder (_Unstable_)
======================
@ -707,7 +721,6 @@ Information is for Version 3.2C
extra -lgnustep-gui in ADDTIONAL_TOOL_LIBS in the
GNUmakefile(.preamble).
RedHat/Intel
============
@ -767,7 +780,7 @@ Tested on Solaris version 6, 7, and 8
Some people have reported problems when using binutils assembler and
linker. Using the native Solaris assmebler and linker should work fine.
linker. Using the native Solaris assmebler and linker should work fine.
Older Instructions: If you are using threads, make sure the
Objective-C runtime (libobjc that comes with gcc) is compiled with
@ -809,11 +822,10 @@ GNUstep has been tested on version 6.2-6.4 of Suse
`Special Instructions'
It seems that there is a problem with the default kernel build
distributed with Suse which means that the socket binding used by
gdnc doesn't work. If you recompile the kernel then it starts
distributed with Suse which means that the socket binding used by
gdnc doesn't work. If you recompile the kernel then it starts
working.
Suse/Intel
==========
@ -822,7 +834,7 @@ Suse
`Recommended compiler'
The default compiler that comes with Susu is fine. Also gcc2.95.x,
gcc3.0.x, 3.1 and 3.2 work, but 2.95 is faster. Compile with
gcc3.0.x, 3.1 and 3.2 work, but 2.95 is faster. Compile with
-threads-enabled (non-standard).
`Extra libs needed'
@ -831,7 +843,6 @@ Suse
`Special Instructions'
None.
Suse 7.x/PPC
============
@ -935,8 +946,8 @@ Unixware-2.1.3/Intel
gdomap -a /etc/gdomap_addresses
If you don't set gdomap up correctly, Distributed Objects will not
work.
If you don't set gdomap up correctly, Distributed Objects will not
work.
Windows with CYGWIN (_Needs Testing_)
=====================================
@ -957,8 +968,7 @@ Windows with CYGWIN (_Needs Testing_)
`Special Instructions'
Make sure you have good shared libraries for everthing. Sometimes
a bad shared library (like libtiff) will cause odd and untraceable
problems. See <README.Cygwin> for information on compiling.
problems. See <README.Cygwin> for information on compiling.
Windows with MinGW
==================
@ -1010,4 +1020,3 @@ to update, for example, go into 'base', and type:
cvs -z3 update -Pd
You don't have to re-checkout after you have the source, just update!