4fc58ad2bdb7bc53ba3af2453e44c7abbd4656ab
[jabaws.git] / binaries / src / ViennaRNA / RNAforester / g2-0.70 / INSTALL
1 Installation
2 ============
3
4 LINUX
5 -----
6
7 Either install RPM packet with binaries, or compile as described in the
8 UNIX section 
9
10 UNIX 
11 ----
12
13 1. Extract package with gzip -dc g2-xxxx.tar.gz | tar xvf - 
14
15 2. Run './configure'
16
17 3. Run 'make depend'
18
19 4. Optionally edit src/g2_config.h to fine-tune g2 behavior (only if
20    you know what are you doing)
21
22 5. Run 'make' 
23
24 6. Run 'make install' or copy libg2.a and g2.h, g2_X11.h, g2_gd.h, and
25    g2_PS.h to the default locations for library and include files. 
26
27 7. cd to demo directory and  run 'make demo' to compile demo
28    applications
29
30 8. To rebuild documentation run 'make doc' (html, PS and pdf manual
31    should be already included into documentation).
32
33
34 WINDOWS NT
35 ----------
36
37 1. Extract package: unzip 'g2-xxxx.zip' 
38
39 2. For gd support, please download the binary gd version and place it in a
40    folder next to g2 using default folder name gdwin32, i.e. it is expected 
41    in ../gdwin32 from the folder this file is residing.
42    You also will need to create the bgd.lib file using makemsvcimport.bat
43    
44 3. MS Visual C++ users can build both library and demos with the supplied
45    project file: g2.xxx 
46    users of gcc or other commandline based compilers with make support
47    continue as in Unix example 
48
49
50 VMS
51 ---
52
53 Note: VMS is not tested in latest builds. However descrip.mms is a
54 good starting point.
55
56 1. set default to root of distribution directory
57
58 2. type mms to build g2.olb library
59
60 3. to compile demo files, set defualt to [.demo] and type mms
61
62 4. to install: copy g2.olb and g2.h, g2_X11.h and g2_PS.h to install
63    directories
64
65
66 PNG-SUPPORT
67 -----------
68
69 g2 needs to be linked to the free available gd library written by
70 Thomas Boutell in order to create PNG files.  g2 is tested with
71 version 2.0.22 of gd. gd is available at http://www.boutell.com/gd/ and
72 at numerous mirror sites.  Use a ftp search
73 (e.g. http://ftpsearch.ntnu.no/) and search for "gd1.3.tar.gz" to find
74 your nearest mirror site.
75
76
77 PERL SUPPORT
78 ------------
79 1. build g2 library
80 2. cd to g2_perl and run
81         perl Makefile.PL
82         make
83         make test
84
85
86 SHARED LIBRARIES
87 ----------------
88 Support for shared libraries is tested on Linux and OSF
89 (DigitalUnix). To build shared libraries type 'make shared'. If you
90 want to run demo applications without installed shared libraries, you
91 should add to LD_LIBRARY_PATH the path to the g2 shared library
92 (e.g. 'export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/some/path/to/g2')
93
94