gschem/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 In order to build gschem you must install the following packages first:
  19
  20         GLIB 2.4.x
  21         GTK+ 2.4.x and all dependancies
  22         guile 1.6.x or later
  23         libgeda (match version and must be installed first)
  24         symbols
  25         LibStroke 0.5.1  (optional)
  26         libgdgeda 2.0.15 (optional; you also need zlib and libpng for this lib)
  27
  28 -----------------------------------------------------------------------------
  29 More detailed info:
  30
  31 - To compile gschem 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   You can specify where rc files are installed by using the --with-rcdir=path
  43   when you run ./configure.  This is useful to package maintainers who would
  44   like to override where gschem and friends search for the rc files.
  45
  46 - To install gschem into the prefix dir (and subdirs) type:
  47
  48                 make install
  49
  50   in gschem's top level directory
  51
  52
  53 gEDA uses GNU Libtool in order to build shared libraries on a
  54 variety of systems. While this is very nice for making usable
  55 binaries, it can be a pain when trying to debug a program. For that
  56 reason, compilation of shared libraries can be turned off by
  57 specifying the `--disable-shared' option to `configure'.
  58
  59 The configure script should figure out most system dependant things, but at
  60 this point I'm either not taking into account what configure figures out or
  61 I have missed some system dependance.  So please e-mail me at:
  62 ahvezda@geda.seul.org
  63
  64
  65 - Disabling strokes
  66
  67   If configure finds libstroke installed it will automatically enable
  68   stroke support.  To disable this run configure like:
  69
  70         ./configure --disable-strokes
  71
  72   Then do:
  73
  74         make clean
  75         make all
  76
  77
  78 - Uninstall
  79
  80   To uninstall a previous version (or the current version) of gEDA type:
  81
  82         make uninstall
  83
  84   in the top level gEDA source directory.  This will remove installed files
  85   which belong to gEDA.
  86
  87
  88 Platform / Vendor specific tips and hints
  89 ------------------------------------------
  90
  91 - libc5 (SuSE)
  92
  93         If you get the following error message:
  94
  95          "link: '-L' cannot specify a relative directory"
  96
  97   There is a problem with readline and guile.  Please hide (rename)
  98   libreadline.so.* (move it out of wherever it is installed) and rebuild
  99   guile again.  Then recompile gEDA and things should work right.
 100
 101 - Redhat 6.0
 102
 103   The guile RPMs that are shipped with RedHat 6.0 has been giving some
 104   people some trouble.  The solution seems to grab either the SRPMS and
 105   build that or get the guile-1.3.tar.gz file and build guile manually.
 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