gschem: Update optional debug printing to work with the latest code
[geda-gaf/peter-b.git] / gnetlist / INSTALL
blobb31b87c4659107e7607274394cfebf89635a787e
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         guile 1.4.x or 1.6.x
23         libgeda
24         symbols
25         LibStroke 0.5.1  (optional)
27 -----------------------------------------------------------------------------
28 More detailed info:
31   First run the configure script in the toplevel directory of gnetlist:
32         
33                 ./configure             (This should guess everything right)
34                                         (e-mail me if it doesn't)       
35                 make all
37   Run: configure --help for more options (such as overriding the default
38   prefix).
40   You can specify where rc files are installed by using the --with-rcdir=path
41   when you run ./configure.  This is useful to package maintainers who would
42   like to override where gschem and friends search for the rc files.
44 - To install gnetlist into the prefix dir (and subdirs) type:
46                 make install
48   in gschem's top level directory
51 gEDA uses GNU Libtool in order to build shared libraries on a
52 variety of systems. While this is very nice for making usable
53 binaries, it can be a pain when trying to debug a program. For that
54 reason, compilation of shared libraries can be turned off by
55 specifying the `--disable-shared' option to `configure'.
57 The configure script should figure out most system dependant things, but at
58 this point I'm either not taking into account what configure figures out or 
59 I have missed some system dependence.  So please e-mail me at: 
60 ahvezda@geda.seul.org
62 - Uninstall
64   To uninstall a previous version (or the current version) of gEDA type:
66         make uninstall
68   in the top level gEDA source directory.  This will remove installed files 
69   which belong to gEDA.
72 Platform / Vendor specific tips and hints
73 ------------------------------------------
75 - libc5 (SuSE) 
77         If you get the following error message:
79          "link: '-L' cannot specify a relative directory"
81   There is a problem with readline and guile.  Please hide (rename) 
82   libreadline.so.* (move it out of wherever it is installed) and rebuild
83   guile again.  Then recompile gEDA and things should work right.
85 - Redhat 6.0
87   The guile RPMs that are shipped with RedHat 6.0 has been giving some 
88   people some trouble.  The solution seems to grab either the SRPMS and
89   build that or get the guile-1.3.tar.gz file and build guile manually.
91 - SunOS / Solaris 
93         If you have problems running the shell script wrappers (when
94         running ./gschem or any of the other programs), try changing
95         the shell to /bin/ksh (or where ksh is).  /bin/sh is known to
96         be of lesser quality on Solaris.
98         Also run ./configure --disable-shared if you have to problems
99         running programs because a shared library isn't be found/loaded.