home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / Mirrors / GNUStep / GNUstep-HOWTO < prev   
Encoding:
Text File  |  1998-02-16  |  12.0 KB  |  417 lines
  1. Installation
  2. ************
  3.  
  4.    GNUstep-HOWTO
  5.  
  6.    Last Update: 9 February 1998
  7.  
  8.    This document explains how to build the different components
  9.    of GNUstep.
  10.  
  11.    Copyright (C) 1996 Free Software Foundation, Inc.
  12.  
  13.    Authors:  Pascal Forget <pascal@wsc.com>,
  14.              Ovidiu Predescu <ovidiu@net-community.com>,
  15.              Adam Fedor <fedor@doc.com>.
  16.  
  17.    This file is part of GNUstep.
  18.  
  19. Introduction
  20. ============
  21.  
  22. This document explains how to build the GNUstep project along with all
  23. the tools required to develop applications with it.
  24.  
  25. In order to easily compile and debug GNUstep projects, you will need a
  26. modified version of the GNU C compiler gcc and of the GNU debugger gdb.
  27.  
  28. You will need at least 80Mb of hard disk space in order to compile the
  29. GNUstep project.  Luckily, you can delete the object files and the
  30. uncompressed source code after each piece of the project has been
  31. successfully built and installed in order to save some space.  The
  32. biggest offender is the gcc compiler, which eats up 50Mb of hard disk
  33. space while it compiles.
  34.  
  35. Summary
  36. =======
  37.  
  38. Currently, you pretty much need to get and install the latest versions
  39. of the following packages:
  40.      gcc or egcs
  41.      gdb and patch to make it work with better Objective-C
  42.      GNU make
  43.      tiff library
  44.      DGS or Adobe DPS
  45.      gstep-make
  46.      gstep-base or libFoundation
  47.      gstep-gui
  48.      gstep-xpds
  49.      FoundationExt (optional).
  50.  
  51. Getting the files
  52. =================
  53.  
  54. Most of the files needed by GNUstep are available from the following ftp
  55. sites. Except for gcc, gdb, make and libtiff, alpha.gnu.org and zarquon
  56. should contain the latest versions of all the required packages.
  57.  
  58. `ftp://ftp.gnu.org/pub/gnu'
  59.      gcc, gdb, and other GNU tools, and GNUstep public releases
  60.  
  61. `ftp://ftp.sgi.com/graphics/tiff'
  62.      TIFF library
  63.  
  64. `ftp://alpha.gnu.org/gnu/gnustep'
  65.      GNUstep developer releases
  66.  
  67. `ftp://ftp.gnustep.org/pub/gnustep'
  68.      All GNUstep releases
  69.  
  70. `ftp://zarquon.mathi.uni-heidelberg.de/pub/GNUstep'
  71.      All GNUstep releases
  72.  
  73. You need the following packages of either the version given or any later
  74. version, in order to compile GNUstep.
  75.  
  76.      gcc-2.8.0.tar.gz (The GCC compiler)
  77.        ftp://ftp.gnu.org/pub/gnu or from other GNU mirror sites.
  78.        You may also use egcs-1.0.1.tar.gz, from ftp://ftp.cygnus.com/pub/egcs
  79.      
  80.      gdb-4.16.tar.gz (The gdb debugger)
  81.      make-3.75.tar.gz (You need GNU make to compile GNUstep).
  82.        ftp://ftp.gnu.org/pub/gnu or from other GNU mirror sites.
  83.      
  84.      gdb-4.16-objc-971112.diff.gz (A patch for easier debugging of Objective-C).
  85.        ftp://alpha.gnu.org/gnu/gnustep
  86.      
  87.      tiff-v3.4beta036-tar.gz (The TIFF library), or
  88.      tiff-970711.tar.gz
  89.        ftp://ftp.sgi.com/graphics/tiff/
  90.        ftp://alpha.gnu.org/gnu/gnustep
  91.        ftp://zarquon.mathi.uni-heidelberg.de/pub/GNUstep/related
  92.      
  93.      pcthreads-1.1.0.tar.gz (PCThreads for Linux/GNU Inel x86 systems)
  94.        ftp://alpha.gnu.org/gnu/gnustep
  95.      
  96.      gstep-make-0.4.0.tar.gz (Makefile package)
  97.      dgs-970711.tar.gz (The Display Ghostscript distribution)
  98.      gstep-base-0.4.0.tar.gz (Foundation)
  99.      gstep-gui-0.4.0.tar.gz (AppKit)
  100.      gstep-xdps-0.4.0.tar.gz (X11/PostScript backend)
  101.        ftp://ftp.gnu.org/pub/gnu
  102.        ftp://alpha.gnu.org/gnu/gnustep
  103.        ftp://zarquon.mathi.uni-heidelberg.de/pub/GNUstep
  104.      
  105.      libFoundation-0.8.0.tar.gz (Foundation)
  106.        ftp://alpha.gnu.org/gnu/gnustep
  107.        ftp://zarquon.mathi.uni-heidelberg.de/pub/GNUstep
  108.      
  109.      FoundationExt-0.8.1.tar.gz (Foundation extentions (optional))
  110.        ftp://ftp.gnu.org/pub/gnu
  111.        ftp://alpha.gnu.org/gnu/gnustep
  112.        ftp://zarquon.mathi.uni-heidelberg.de/pub/GNUstep
  113.  
  114. You may get either one of the Foundations libraries (you only need to
  115. take one of them, not both) gstep-base or libFoundation.
  116.  
  117. Note that you should get the latest version available, not necessarily
  118. the one listed here. For the more adventurous, and since the project is
  119. still in development, it might be better to get the latest snapshot
  120. located in the snap or snapshot subdirectories at
  121. ftp://alpha.gnu.org/gnu/gnustep or the other appropriate ftp locations.
  122.  
  123. For the following instructions, some version numbers are replaced by
  124. XXX.  You shoule replace the 'X's with the version of the package you
  125. have.
  126.  
  127. Compiling and Installing the packages
  128. =====================================
  129.  
  130. Compiling make
  131. --------------
  132.  
  133. GNU make is required to compile all GNUstep packages.
  134.  
  135.      cd /usr/src
  136.      tar fvxz make-XXX.tar.gz
  137.      cd make-XXX
  138.      ./configure
  139.      make
  140.      su root
  141.      make install
  142.  
  143. Installing the Makefile package
  144. -------------------------------
  145.  
  146. First decide where you want the GNUstep files to go, and use this as an
  147. argument to configure in the makefile package. If you don't choose a
  148. location, the default is /usr/GNUstep.  The example below shows how to
  149. configure the packages for installation in /usr/local/GNUstep.
  150.  
  151.      tar fvxz gstep-make-XXXXXX.tar.gz
  152.      cd gstep-make-XXXXXX
  153.      ./configure --prefix=/usr/local/GNUstep
  154.      su root
  155.      make install
  156.  
  157. If you are using, or intend to compile the GCC Objective-C runtime with
  158. threads, you need to specify the thread package you are using when
  159. running configure:
  160.  
  161.      LIBS=-lpthread; ./configure --prefix=/usr/local/GNUstep
  162.  
  163. After this you should add the shell script `GNUstep.sh' in the makefile
  164. package to you initialization file (such as `.profile'). For instance:
  165.  
  166.      . /usr/local/GNUstep/Makefiles/GNUstep.sh
  167.  
  168. in your `.profile' file will work. It defines environment variables that
  169. are needed to find GNUstep files and executables.  Users of csh need to
  170. change the `GNUstep.sh' script so it will work with csh. Read the
  171. `README' for more info.
  172.  
  173. GNUstep packages will automatically install in this directory
  174. structure. You can install other packages (such as gcc) in the same
  175. structure if you specify the GNUstep system root as the prefix when you
  176. configure the package.
  177.  
  178.      ./configure --prefix=$GNUSTEP_SYSTEM_ROOT
  179.  
  180. Compiling PCThreads
  181. -------------------
  182.  
  183. For Linux/GNU systems on Intel x86 processors, the PCThreads library is
  184. known to work with GNUstep.  PCThreads version 1.1.0 is an enhanced
  185. version of PCThread 1.0.0 with better support for GNUstep.
  186.  
  187.      cd /usr/src
  188.      tar fvxz pcthreads-1.1.0.tar.gz
  189.      cd pcthreads-1.1.0
  190.      ./configure
  191.      make
  192.      su root
  193.      make install
  194.  
  195. If you are using the GNUstep makefile package and wish PCThreads to be
  196. installed with the GNUstep directory structure; then you should specify
  197. the GNUstep system root as the prefix when you configure the package.
  198.  
  199.      ./configure --prefix=$GNUSTEP_SYSTEM_ROOT
  200.  
  201. Patching and Compiling GCC
  202. --------------------------
  203.  
  204. The following commands assume that all the aforementioned files have
  205. been copied to the /usr/src directory on your machine.
  206.  
  207. 1. Uncompress gcc:
  208.        cd /usr/src
  209.        tar fvxz gcc-2.8.0.tar.gz
  210.  
  211. 2. Configure the gcc compiler's makefile for your machine:
  212.        ./configure
  213.  
  214.      If you are using the GNUstep makefile package and wish gcc to be
  215.      installed with the GNUstep directory structure; then you should
  216.      specify the   GNUstep system root as the prefix when you configure
  217.      the package.
  218.  
  219.      To enable multiple threads in the Objective-C library use the
  220.      -ENABLE-THREADS=LIB argument to configure, where LIB is the
  221.      thread library to use or -DISABLE-THREADS   to use a
  222.      single-threaded Objective-C runtime.
  223.  
  224.      ./configure --prefix=$GNUSTEP_SYSTEM_ROOT
  225.  
  226. 4. Compile gcc
  227.      make
  228.  
  229.      or
  230.  
  231.      make bootstrap
  232.  
  233. 5. Wait
  234.        If you have a Pentium Pro, go drink a coffee.
  235.        If you have a fast Pentium, count from 0 to 100 in your head.
  236.        If you have a slow Pentium, go eat a bagel.
  237.        If you have a 486, go watch the news.
  238.        If you have a 386, come back tomorrow.
  239.  
  240. 6. Install gcc
  241.        su root
  242.        make install
  243.  
  244. 7. Delete the gcc directory if you're low on disk space
  245.        rm -rf /usr/src/gcc-2.8.0
  246.  
  247. Patching and Compiling GDB
  248. --------------------------
  249.  
  250. Uncompress GDB, and patch it:
  251.        cd /usr/src
  252.        tar fvxz gdb-4.16.tar.gz
  253.        gunzip gdb-4.16-objc-971112.diff.gz
  254.        cd gdb-4.16
  255.        patch -p1 < ../gdb-4.16-objc-971112.diff
  256.  
  257. Configure, compile and install gdb:
  258.        cd /usr/src/gdb-4.16
  259.        ./configure
  260.        make
  261.        su root
  262.        make install
  263.  
  264.      If you are using the GNUstep makefile package and wish gdb to be
  265.      installed with the GNUstep directory structure; then you should
  266.      specify the   GNUstep system root as the prefix when you configure
  267.      the package.
  268.  
  269.        ./configure --prefix=$GNUSTEP_SYSTEM_ROOT
  270.  
  271. 4. Make sure gdb is where you think it is
  272.      On Linux/GNU, gdb should be installed in /usr/bin, whereas   on
  273.      other systems, the default installation path is   usually
  274.      /usr/local/bin.  If you have a Linux/GNU box,   you can do this:
  275.  
  276.        ln -s /usr/local/bin/gdb /usr/bin/gdb
  277.  
  278.      Note that this is only a suggestion, you are free to do   whatever
  279.      you want.
  280.  
  281. Compiling libtiff
  282. -----------------
  283.  
  284. You don't need a customized version of libtiff, or necessarily even the
  285. newest one, but the customized version located at the GNUstep ftp sites
  286. will install in the GNUstep directory structure.
  287.  
  288.        cd /usr/src
  289.        tar fvxz tiff-XXXXX.tar.gz
  290.        cd tiff-XXX
  291.        ./configure
  292.        make
  293.        su root
  294.        make install
  295.  
  296. Building DGS
  297. ------------
  298.  
  299. If you have a real Display Postscript system already on your computer,
  300. you don't necessarily need DGS. Linux/GNU michines need DGS.  You can
  301. also read the file DGS-HOWTO located at the ftp machines listed above.
  302.  
  303.        tar fvxz dgs-XXXXXX.tar.gz
  304.        cd dgs-XXXXXX
  305.        ./configure
  306.        make
  307.        su root
  308.        make install
  309.  
  310. Building a Foundation library
  311. -----------------------------
  312.  
  313. With this and the following packages that use the GNUstep makefile
  314. package you can use the various switches, shared, debug. As in ``make
  315. shared=no debug=yes'' (Make sure you use the same switches for every
  316. package you compile, and also when you install).
  317.  
  318. If you work with gstep-base:
  319.  
  320.        cd /usr/src
  321.        tar fvxz gstep-base-XXXXXX.tar.gz
  322.        cd gstep-base-XXXXXX
  323.        ./configure
  324.        make
  325.        su root
  326.        make install
  327.  
  328. On some Linux systems, you may have to change the optimization level
  329. (particularly if you get an error compiling mframe.m):
  330.  
  331.        make OPTFLAG=-O
  332.  
  333. If you work with libFoundation:
  334.  
  335.        cd /usr/src
  336.        tar zxf libFoundation-0.8.0.tar.gz
  337.        cd libFoundation-0.8.0/libFoundation
  338.        ./configure --with-gnustep
  339.        make
  340.        su root
  341.        make install
  342.  
  343. Building the GUI libraries
  344. --------------------------
  345.  
  346. Compile the GUI library:
  347.  
  348.        cd /usr/src
  349.        tar zxf gstep-gui-XXXXXX.tar.gz
  350.        cd gstep-gui
  351.        make
  352.        su root
  353.        make install
  354.  
  355. Compile the XDPS library:
  356.  
  357.        cd /usr/src
  358.        tar zxf gstep-xdps-XXXXXX.tar.gz
  359.        cd gstep-xdps
  360.        ./configure
  361.        make
  362.        cd Testing
  363.        make
  364.  
  365. Building the Foundation extensions
  366. ----------------------------------
  367.  
  368. The Foundation extensions have some useful features in them. The one
  369. reason you definitely might want to use it is to read in GNUstep model
  370. files which store User Interface structures in ASCII format, and can
  371. also be used to translate NeXT and OpenStep NIB files to GNUstep model
  372. format.
  373.  
  374. Compiling:
  375.  
  376.        cd /usr/src
  377.        tar zxf FoundationExt-XXX.tar.gz
  378.        cd extensions
  379.        make
  380.        su root
  381.        make install
  382.  
  383. Additional Installation
  384. =======================
  385.  
  386. Set up your home GNUstep directory. This is where user defaults are
  387. kept, and in the future, other files may be kept there.
  388.  
  389.      cd
  390.      mkdir GNUstep
  391.  
  392. Next, set your local time zone.  There are three ways to do this, pick
  393. one:
  394.  
  395.   1. Use the dwrite utility to set ``Local Time Zone'' to your local
  396.      time zone.
  397.  
  398.   2. Set the TZ environment variable.
  399.  
  400.   3. Create the file
  401.  
  402.  
  403.  
  404.  
  405.  
  406.      `$GNUSTEP_SYSTEM_ROOT/Libraries/Resources/gnustep/NSTimeZones/localtime'
  407.      with the name of the local time zone in it.
  408.  
  409. Finally, run the tests in the Testing directory. Use the openapp utility
  410. that is part of the GNUstep makefile package (and stored in
  411. `$GNUSTEP_SYSTEM_ROOT/Tools'). Usage is:
  412.  
  413.      openapp [--library-combo=...] application [additional arguments to app]
  414.  
  415. Good Luck!
  416.  
  417.