## AiksaurusGTK User's Guide

### Installation Instructions

> Note: these instructions require root access to your computer. If you want to install AiksaurusGTK on a computer that isn't yours, you should get permission from your systems administrator first.

> Step 1: Install GTK+

>   AiksaurusGTK requires the GTK+ library to work correctly. Most Linux systems will already have this installed. You can run the command:

>   `gtk-config --version`

>   To find out what version of GTK you have installed. If you get the message "command not found", this means that you will need to install GTK+ first. Please consult the GTK+ web site for how to do this.

> Step 2: Install Aiksaurus Core Library

>   AiksaurusGTK also requires the Aiksaurus core library. Your system probably does not have this installed already. However, you can run the command:

>   `aiksaurus --version`

>   To find out what version of the core library you have installed. If you get the message "command not found", this means you will need to install the core library first. Please consult the Aiksaurus web site for how to do this.

> Step 3: Download AiksaurusGTK Package

>   You should now be ready to download AiksaurusGTK.

>   You should download a file named AiksaurusGTK-?.??.tar.gz (where ?.?? is the most recent version of AiksaurusGTK).

>   Now, this is a compressed file. You should be able to extract it by running the commands:

>   `gunzip AiksaurusGTK-?.??.tar.gz
>   tar xvf AiksaurusGTK-?.??.tar`

>   This will create the directory AiksaurusGTK-?.??. Go to this new directory and type in:

>   `./configure`

>   This should do a lot of stuff and eventually tell you something like:

>   `config.status: creating Makefile
>   config.status: creating src/Makefile
>   config.status: creating src/config.h
>   `

>   If so, you've configured to build successfully. If not, please check your dependencies (steps 1 and 2). If this fails, send me an email and we'll figure out what's wrong.

>   Once ./configure is done, you should be able to compile the program using the command

>   `make`

>   This should spit out a lot of output and not produce any errors. If it does produce an error, please email me because there's a serious problem.

>   Finally, you need to become root (via "su") and run the command

>   `make install`

>   This will install a library to /usr/lib, a header file to /usr/include, and a program to /usr/bin. You can then become your regular user again (via "exit"). AiksaurusGTK should now be installed.

>   You can test your installation by running the command:

>   `AiksaurusGTK`

>   Which should pop up the thesaurus.

> Step 4: Cleaning Up (optional)

>   You can delete the entire Aiksaurus-?.?? directory that was created, and the Aiksaurus-?.??.tar file that you downloaded. These files are not needed for Aiksaurus to run, and can clear up some disk space.

### Using the Thesaurus

> The thesaurus should be fairly self-explanatory. The back and forward buttons let you go to previous and future searches like a web browser. The dropdown box in the toolbar lets you type in words to search for or access recent searches. Finally, you can double-click on listed synonyms to jump to them.

> There are some command line switches which can be viewed by running

> `AiksaurusGTK --help`

### Uninstallation Instructions

> If you still have the Aiksaurus-?.?? directory around, you can uninstall the thesaurus by running "make uninstall" in that directory. This will require root access.

> If you deleted that directory, you can still manually uninstall by deleting the files:

> - /usr/lib/libAiksaurusGTK.*
> - /usr/include/AiksaurusGTK.*
> - /usr/bin/AiksaurusGTK

Copyright © 2001 by Jared Davis.
This documentation may be freely distributed and modified without restriction.