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