Development version

Another way to get GgrTF is to go to the very source, the development source repository. This repository contains the latest bleeding edge features, but is also a fast moving target. Changes are directly committed by developers almost in real time, sometimes what you download may be severely broken. Also the documentation will not be updated for every little change, so you may have to figure out and work around possible backward incompatibilities yourself.

New features and bugfixes may sometimes be worth taking the risk. On the other hand, it is all up to what you want and whether you can manage to handle the possibly arising problems.

We utilize Mercurial (Hg) for GgrTF's version management. Mercurial is a freely available distributed version control system, for which there are clients available for most common platforms, including Windows, Linux and other flavours of UNIX.

GgrTF's Mercurial repository is hosted at tnsp.org, and is available from following location: https://tnsp.org/hg/batmud/ggrtf/. The same URL can be used with a web browser to browse version history.

Checking out

You can download (aka "clone") the GgrTF repository with command line Mercurial client with following command: hg clone https://tnsp.org/hg/batmud/ggrtf/ dest_dir In which "clone" means making a local copy of the repository under directory dest_dir.

You will most probably want to download the repository to some specific place, personally I prefer to use ~/ggrtf/ (aka "ggrtf/" under user's home directory) under UNIX. Thus typically you would use following command: hg clone https://tnsp.org/hg/batmud/ggrtf/ ~/ggrtf If you are using Windows, and wish to use the development version, you can use the regular Mercurial command line client, or a GUI interface such as TortoiseHg.

The procedures for cloning and updating your local copy of the repository are otherwise similar, except the directory/folder path is different, under Windows XP the path would be C:\Documents and Settings\<username>\ggrtf\. For example, if your username is "Ggr", you could use the following command: hg clone https://tnsp.org/hg/batmud/ggrtf/ "C:\Documents and Settings\Ggr\ggrtf\" Under Windows Vista and 7, the path is of the format C:\Users\<username>\

Keeping up to date

After you have checked out your own copy of GgrTF's code repository, you usually wish to periodically update it. This is done easily with the following commands: cd ~/ggrtf hg pull hg update Notice that since Mercurial is a distributed version management system, you can easily keep your own local changes by committing them ('hg ci') and then, instead of using 'pull' and 'update', you can use 'hg fetch' to merge your local changesets automatically. Refer to Mercurial documentation.

If you plan on making modifications to GgrTF, it is recommended that you familiarize yourself with the basics of Mercurial workflow, making commits, fetching, etc. It will help you with maintaining your changes locally or sending patches to us.