libgeda/INSTALL

   1 gEDA
   2
   3 GPL Electronic Design Automation
   4 ------------------------------------------------------------------------------
   5
   6 Installation instructions
   7
   8 Please see the end of this file for platform / vendor specific hints and
   9 tips.  Also please read the README file in this same directory.
  10
  11 -----------------------------------------------------------------------------
  12 Quick Ref:
  13
  14 % ./configure
  15 % make
  16 % make install
  17
  18 (Depending on where you installed the libraries, you might have to run
  19  ldconfig (as root)).
  20
  21 In order to build libgeda you must install the following packages first:
  22
  23         GLIB 2.4.x
  24         GTK+ 2.4.x and all dependancies
  25         guile 1.6.x or later
  26         LibStroke 0.5.1  (optional)
  27         libgdgeda 2.0.15 (optional; you also need zlib and libpng for this lib)
  28
  29 -----------------------------------------------------------------------------
  30 More detailed info:
  31
  32 - To compile libgeda with gtk+ installed in some system directory (/usr/local
  33   for example) type:
  34
  35
  36                 ./configure             (This should guess everything right)
  37                                         (e-mail me if it doesn't)
  38                 make all
  39
  40   Run: configure --help for more options (such as overriding the default
  41   prefix).
  42
  43 - To install libgeda into the prefix dir (and subdirs) type:
  44
  45                 make install
  46
  47   in libgeda's top level directory
  48
  49
  50 gEDA uses GNU Libtool in order to build shared libraries on a
  51 variety of systems. While this is very nice for making usable
  52 binaries, it can be a pain when trying to debug a program. For that
  53 reason, compilation of shared libraries can be turned off by
  54 specifying the `--disable-shared' option to `configure'.
  55
  56 The configure script should figure out most system dependant things, but at
  57 this point I'm either not taking into account what configure figures out or
  58 I have missed some system dependance.  So please e-mail me at:
  59 ahvezda@geda.seul.org
  60
  61
  62 - Disabling strokes
  63
  64   If configure finds libstroke installed it will automatically enable
  65   stroke support.  To disable this run configure like:
  66
  67         ./configure --disable-strokes
  68
  69   Then do:
  70
  71         make clean
  72         make all
  73
  74
  75 - Uninstall
  76
  77   To uninstall a previous version (or the current version) of gEDA type:
  78
  79         make uninstall
  80
  81   in the top level gEDA source directory.  This will remove installed files
  82   which belong to gEDA.
  83
  84
  85 Platform / Vendor specific tips and hints
  86 ------------------------------------------
  87
  88 - libc5 (SuSE)
  89
  90         If you get the following error message:
  91
  92          "link: '-L' cannot specify a relative directory"
  93
  94   There is a problem with readline and guile.  Please hide (rename)
  95   libreadline.so.* (move it out of wherever it is installed) and rebuild
  96   guile again.  Then recompile gEDA and things should work right.
  97
  98 - Redhat 6.0
  99
 100   The guile RPMs that are shipped with RedHat 6.0 has been giving some
 101   people some trouble.  The solution seems to grab either the SRPMS and
 102   build that or get the guile-1.3.tar.gz file and build guile manually.
 103
 104   It is important to install *-devel rpms for the various packages
 105   which gEDA depends upon.  gEDA will not build without them being
 106   installed.
 107
 108 - libstroke
 109
 110         Be sure you do not compile libstroke with MOUSE_DROPPINGS defined;
 111         it won't work at all with gschem.  You would have had to manually
 112         define MOUSE_DROPPINGS, so if you just followed the build
 113         instructions you should be okay.
 114
 115
 116 - SunOS / Solaris
 117
 118         If you have problems running the shell script wrappers (when
 119         running ./gschem or any of the other programs), try changing
 120         the shell to /bin/ksh (or where ksh is).  /bin/sh is known to
 121         be of lesser quality on Solaris.
 122
 123         Also run ./configure --disable-shared if you have to problems
 124         running programs because a shared library isn't be found/loaded.
 125