Chapter 2. Installation

Table of Contents

Releases
Development version
Checking out
Keeping up to date

This chapter assumes that you have already succesfully installed TinyFugue in your system and you know how to use it (basic commands, loading of macros, etc.) It is also assumed that you know how to use your operating system of choice, be it some flavour of UNIX or Windows, although some parts of the instructions are given in step-by-step manner.

Note

Throughout this manual, when GgrTF files are referenced in configuration examples etc., I have used "ggrtf/" -directory as path where the script files are located relative to your "home directory". You may need to substitute it with whatever you have installed your copy of GgrTF files in.

There are basically two ways how to get GgrTF, release packages and the Mercurial-repository. Releases are considered as stable snapshots, which should be relatively bug-free, but releases are done somewhat infrequently and at least in this phase we don't backport bugfixes to release versions.

If you are unsure which version to choose, use the latest packaged release.

Releases

To get the latest stable version, head to the downloads-section of GgrTF's homepage and pick either the newest tarball (*.tar.gz) or zip-archive (*.zip):

  • *.tar.gz packages are for UNIX-like systems, such as Linux, *BSD, etc. Please note that the ZIP-packages are meant for Windows only and WILL NOT WORK under UNIX or OS X version of TinyFugue!

  • *.zip packages are for Windows version of TinyFugue (the files have been converted to CRLF line endings.)

Both package types also have equivalent PGP/GnuPG signature files (*.asc), which can be used to cryptographically verify the authenticity of files.

To "install" the package, you simply unpack it to appropriate directory, typically under your home directory. Under UNIX-style system:

cd $HOMEtar xzvf ggrtf-0.7.4.2.tar.gz

After that, you should have directory $HOME/ggrtf/ with all the *.tf files in it. If so, you can continue to the configuration part.