Added missing file to EXTRA_DIST
[geda-gaf/whiteaudio.git] / gsymcheck / INSTALL
bloba6fcd514a3c0916c226715263336df80f4fb570e
1 gEDA
3 GPL Electronic Design Automation
4 ------------------------------------------------------------------------------
6 Installation instructions 
8 Please see the end of this file for platform / vendor specific hints and 
9 tips.
11 -----------------------------------------------------------------------------
12 Quick Ref:
14 % ./configure 
15 % make 
16 % make install
18 In order to build gschem you must install the following packages first:
20         GLIB 1.2.x
21         GTK+ 1.2.x
22         libgeda
23         symbols
24         LibStroke 0.5.1  (optional)
26 -----------------------------------------------------------------------------
27 More detailed info:
30   First run the configure script in the toplevel directory of gnetlist:
31         
32                 ./configure             (This should guess everything right)
33                                         (e-mail me if it doesn't)       
34                 make all
36   Run: configure --help for more options (such as overriding the default
37   prefix).
39   You can specify where rc files are installed by using the --with-rcdir=path
40   when you run ./configure.  This is useful to package maintainers who would
41   like to override where gschem and friends search for the rc files.
43 - To install gnetlist into the prefix dir (and subdirs) type:
45                 make install
47   in gschem's top level directory
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'.
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
61 - Uninstall
63   To uninstall a previous version (or the current version) of gEDA type:
65         make uninstall
67   in the top level gEDA source directory.  This will remove installed files 
68   which belong to gEDA.
71 Platform / Vendor specific tips and hints
72 ------------------------------------------
74 - libc5 (SuSE) 
76         If you get the following error message:
78          "link: '-L' cannot specify a relative directory"
80   There is a problem with readline and guile.  Please hide (rename) 
81   libreadline.so.* (move it out of wherever it is installed) and rebuild
82   guile again.  Then recompile gEDA and things should work right.
84 - Redhat 6.0
86   The guile RPMs that are shipped with RedHat 6.0 has been giving some 
87   people some trouble.  The solution seems to grab either the SRPMS and
88   build that or get the guile-1.3.tar.gz file and build guile manually.
90 - SunOS / Solaris 
92         If you have problems running the shell script wrappers (when
93         running ./gschem or any of the other programs), try changing
94         the shell to /bin/ksh (or where ksh is).  /bin/sh is known to
95         be of lesser quality on Solaris.
97         Also run ./configure --disable-shared if you have to problems
98         running programs because a shared library isn't be found/loaded.