1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
----------------------------------------------------------------------
tkWorld-1.0.0
Wes's Own Real Lazy Desktop
Written By Wes Bailey
tkworld@tkworld.org
http://www.tkworld.org
----------------------------------------------------------------------
NOTE: Though document makes reference to version 1.0.0, the
information is still the current for newer releases.
INSTALLATION
------------
Step 1. Download the latest version of the product type that are
interested in.
Alpha Release
Beta Release
Stable tkWorld Distribution
Step 2. Move the distribution file to where you want tkWorld to live
and extract it as in the example below:
root$ tar -zxvf tkWorld-1.0.0.tgz
Step 3. Change to the tkWorld directory and run the installation
script:
root$ cd tkWorld
root/tkWorld$ ./install
Step 4. The tkWorld installer will come up. Fill out the
installation form with the following in mind:
Application Directory: This is where all of the source code
lives which the Tcl/Tk interpreter reads to run the
application.
Executable Link: In order for the user to execute tkWorld, a
link must be placed in a directory that is in the user's path
so that when the user executes the link, it will start the
Tcl/Tk interpreter and run tkWorld.
Step 5. If the installation is successful, the installer will present
text describing what directories where created and a full tree of the
tkWorld Application Object Library. The buttons also change into the
following:
Test: This button will test the tkWorld application by testing
the executable link.
Page Up: Use this button to move the text in the widget up.
Page Down: Use this button to move the text in the widget
down.
Exit: Exit the tkWorld installer.
TROUBLESHOOTING
---------------
If the installer gives an error, you install tkWorld manually by
following the steps below:
Step 1. Move the distribution file to where you want tkWorld to live
and extract it as in the example below:
root$ mv tkWorld-1.0.0.tgz /usr/local/src
root$ cd /usr/local/src
root:/usr/local/src$ tar -zxvf tkWorld-1.0.0.tgz
Step 2. Now setup up the permissions using the following set of
commands:
root:/usr/local/src$ find tkWorld/ -type d | xargs chmod 755
root:/usr/local/src$ find tkWorld/ -type f | xargs chmod 644
root:/usr/local/src$ chmod 755 tkWorld/tkWorld
Step 3. Test the application works by typing:
root:/usr/local/src$ tkWorld/tkWorld
Step 4. If the application comes up in Step 3, then create a link to
the file from the appropriate bin directory:
root:/usr/local/src$ cd ../bin
root:/usr/local/bin$ ln -s /usr/local/src/tkWorld/tkWorld tkworld
If the installation is successful and all the paths are set up
correctly, you should be able to type the following at the prompt:
HendrixRules> tkworld
and the application will come on screen. If for some reason the script
does not come, check to make sure the bin directory is in your path
using the following example as a guide
HendrixRules:~> echo $HOME
/home/wesb
HendrixRules:~> echo $PATH | sed -e 's/:/\
> /g' -e 's/\/home\/wesb\/bin/INPATH/g' | grep INPATH
INPATH
HendrixRules:~>
Using sed is a little trick to save you eyes from looking at stuff
that is not obvious. The last \ on the 3rd line stands for a carriage
return, and the > means the shell is still making your command.
If you cannot get this little trick to work, then just echo $PATH and
look for /usr/local/bin if you followed the example above, or wherever
you made the link.
If the application does not come on screen, then debug each step in
the process above, checking permissions and file existence.
As a last resort, visit the tkWorld Homepage at
http://www.tkworld.org/bug_report.html
and send a bug report.
|
