Debian Codegraph @

GUI/PWgui/INSTALL

raw
1
2 ________________________________________________________________________
3
4 *** INSTALLATION instructions for PWgui ***
5 ________________________________________________________________________
6
7
8 The PWgui package comes in two flavors:
9
10 (i) STANDALONE EXECUTABLE, which runs out of the box (but works
11 only on the platform for which it has been built)
12
13 (ii) SOURCE PACKAGE
14
15 N.B.: for the usage of repository version of PWgui see file INSTALL.repository
16
17 ________________________________________________________________________
18
19 (i) Installation instructions for STANDALONE EXECUTABLE
20 ________________________________________________________________________
21
22 For zipped pwgui-xxx.zip package do:
23
24 * unzip pwgui-xxx.zip
25
26 whereas for tar-gzipped pwgui-xxx.tgz package do either:
27
28 * tar zxvf pwgui-xxx.tgz
29 or:
30 * gunzip -c pwgui-xxx.tgz | tar xvf -
31
32 To launch the program type either:
33
34 * ./pwgui
35 or
36 * pwgui
37
38
39 The standalone executable is always available for Linux platform, and
40 occasionally also for Mac and Windows.
41
42
43 ________________________________________________________________________
44
45 (ii) Installation instructions for SOURCE PACKAGE
46 ________________________________________________________________________
47
48
49 To use the source package you need required Tcl software, in
50 particular Tcl + Tk + Itcl + Itk + Iwidgets. PWgui requires the Tcl/Tk
51 version 8.4 or later. You may install the software from your OS
52 distribution.
53
54 For example, for GNU/Linux Debian-based distributions, execute as root
55 (or sudo):
56
57 * apt-get update; apt-get install iwidgets4
58
59 (this will install also tcl/tk/itcl/itk, because iwidgets depend on them).
60 On RedHat-based distributions, the analogous command is "yum". Hence:
61
62 * yum install iwidgets
63
64 As for the Archlinux consider the following installation instructions
65 (due to Gonzalo Aguirre): neither itk nor iwidgets are in the official
66 repositories, so they should be obtained from the AUR using the
67 following recipe:
68
69 * yaourt -S itk-cvs
70 * yaourt -S iwidgets
71
72 If an issue arises during the iwidgets installation, check where the
73 itk-cvs is installed (pacman -Ql itk-cvs) and specify the directory
74 explicitly while building the iwidgets package (e.g.:
75 --with-itk=/usr/lib/itk3.4)
76
77
78 Alternatively you may install ActiveTcl8.4 (which has all the required
79 software built-in) from:
80
81 http://www.activestate.com/activetcl/downloads/
82
83 BEWARE: do not install the newer 8.5 or 8.6 version of ActiveTcl,
84 because they do not contain all the needed software. The
85 version 8.4 is mandatory !!!
86
87
88 Once your computer has all the needed software, your source package is
89 ready to run. You only need to untar the PWgui source tarball, i.e.:
90
91 * gunzip -c PWgui-<version>.tgz | tar xvf -
92 or
93 * tar zxvf PWgui-<version>.tgz
94
95 where <version> stands for version number. To launch the PWgui
96 program, type: pwgui.
97
98 You may add the PWgui root directory to your PATH.
99
100 If you would like to copy "pwgui" launcher to some common place, such
101 as /usr/local/bin, then you need either to define PWGUI environmental
102 variable so that "pwgui" will be able to locate its root directory
103 (i.e. source files) or alternatively hardcode it into pwgui lanucher
104 itself.
105