gnetlist/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.
  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 1.2.x
  21         GTK+ 1.2.x
  22         guile 1.4.x or 1.6.x
  23         libgeda
  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
  32   First run the configure script in the toplevel directory of gnetlist:
  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 gnetlist 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 - Uninstall
  64
  65   To uninstall a previous version (or the current version) of gEDA type:
  66
  67         make uninstall
  68
  69   in the top level gEDA source directory.  This will remove installed files
  70   which belong to gEDA.
  71
  72
  73 Platform / Vendor specific tips and hints
  74 ------------------------------------------
  75
  76 - libc5 (SuSE)
  77
  78         If you get the following error message:
  79
  80          "link: '-L' cannot specify a relative directory"
  81
  82   There is a problem with readline and guile.  Please hide (rename)
  83   libreadline.so.* (move it out of wherever it is installed) and rebuild
  84   guile again.  Then recompile gEDA and things should work right.
  85
  86 - Redhat 6.0
  87
  88   The guile RPMs that are shipped with RedHat 6.0 has been giving some
  89   people some trouble.  The solution seems to grab either the SRPMS and
  90   build that or get the guile-1.3.tar.gz file and build guile manually.
  91
  92 - SunOS / Solaris
  93
  94         If you have problems running the shell script wrappers (when
  95         running ./gschem or any of the other programs), try changing
  96         the shell to /bin/ksh (or where ksh is).  /bin/sh is known to
  97         be of lesser quality on Solaris.
  98
  99         Also run ./configure --disable-shared if you have to problems
 100         running programs because a shared library isn't be found/loaded.
 101