D 2015-09-17T04:32:16.188
L INSTALL.txt
N text/x-markdown
U iamdave
W 5032
To install for windows
----------------------
Download ActiveState's free Community Edition Tcl installer (includes the Img package):
<div style="text-indent:40px">[http://www.activestate.com/activetcl/downloads](http://www.activestate.com/activetcl/downloads)</div>
Note that if you wish to install for 'all users' or install into **C\\:Program Files\\Tcl**, you must run the installer 'as Administrator' and provide the installation folder name.
To make a nice shortcut on your desktop or in your start menu, right-click **Guide.tcl**, drag to a folder and click 'Create shortcuts here'. Right-click the shortcut and select 'Properties'. Assuming you installed Tcl to **C:\\Program Files\\Tcl**, modify 'Target:' by inserting:
<div style="text-indent:40px">"C:\Program Files\Tcl\\bin\wish.exe"</div>
prior to the full path to **Guide.tcl**. Be sure to enclose the path to **wish.exe** with double-quotes and separate from the original target with a space.
Click on 'Change icon...', browse to the folder containing **Guide.tcl** and select **Logo.ico**.
Click 'Apply' and 'OK'. Rename the shortcut to whatever you like.
To install for Linux
--------------------
I've only tested this procedure on Ubuntu 14.04
Test to see if Tcl is pre-installed; type `locate wish`. Assuming you found it in one of the system directories, make sure that directory is in your **PATH**.
Type `wish` and you will get a "% " prompt.
Type `set tcl_patchLevel`
You will see a string of numbers such as "8.6.4". If the first two numbers are "8.6" or higher, continue.
Type `package require Img`
If you see a string of numbers (something like "1.4.3"), then the Img package is present and you are finished.
Type `exit` to quit the Tcl interpreter.
If your version of Tcl is at least 8.6 but you saw "can't find package Img", you will need to install the "Img" package. For Ubuntu, type:
<div style="text-indent:40px">`sudo apt-get install libtk-img`</div>
<br>If Tcl is not pre-installed or is not at least 8.6, you can download ActiveState's free Community Edition (includes Img package):
<div style="text-indent:40px">[http://www.activestate.com/activetcl/downloads](http://www.activestate.com/activetcl/downloads)</div>
Then type (for example):
<div style="text-indent:40px">`tar zxf ActiveTcl8.6.4.1.299124-linux-ix86-threaded.tar.gz`
</div><div style="text-indent:40px">`cd ActiveTcl8.6.4.1.299124-linux-x86_64-threaded`
</div><div style="text-indent:40px">`sudo install.sh`</div>
When complete, add **/opt/ActiveTcl-8.6/bin** to your **PATH**.
To install for other unix variants
----------------------------------
If your unix variant is not supported, you will have to do some research on your own. Perhaps your distribution has a package repository. If so, install Tcl and the Img package if possible.
If not, then unfortunately you will have to compile and install Tcl and Tk from source, and do the same for the Img package.
You can download the Tcl & Tk source here:
<div style="text-indent:40px">[http://www.tcl.tk/software/tcltk/download.html](http://www.tcl.tk/software/tcltk/download.html)</div>
The Img package home page is:
<div style="text-indent:40px">[http://sourceforge.net/projects/tkimg/](http://sourceforge.net/projects/tkimg/)</div>
To install for Macintosh
------------------------
I do not have access to a Macintosh system. If Tcl is not already installed, you should try ActiveState's free Community Edition (I would guess that this also includes the Img package):
<div style="text-indent:40px">[http://www.activestate.com/activetcl/downloads](http://www.activestate.com/activetcl/downloads)</div>
Download and install the Mac OS X package.
If you cannot install the ActiveState edition, then unfortunately you will have to compile and install Tcl and Tk from source, and do the same for the Img package. See above for the URL's to download the source.
How to Run the Location Guide
-----------------------------
The location guide is the Tcl script **Guide.tcl**
Windows
<div style="text-indent:40px">Double-click **Guide.tcl** or the shortcut you created</div>
Linux/Unix
<div style="text-indent:40px">`chmod +x ./Guide.tcl`
</div><div style="text-indent:40px">`./Guide.tcl`</div>
<div style="text-indent:40px">You might also create a symbolic* link in your <strong>bin</strong> directory:
</div><div style="text-indent:80px"><code>ln -s <path to Guide.tcl> $HOME/bin/Guide</code>
</div><div style="text-indent:40px">Assuming <strong>$HOME/bin</strong> is in your <strong>PATH</strong>, just type <code>Guide</code>.</div><br>
<div style="text-indent:40px">* A hard link will not work; the program must be able to locate the directory containing <strong>Guide.tcl</strong>.</div>
Macintosh
<div style="text-indent:40px">I suspect that `wish Guide.tcl` will work.</div>
Customizing
-----------
The font can be changed (up to a point). See the **Options.tcl** file.
Z 4a19662deb0772314c8490d5655a7d8e