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