# HG changeset patch # User Matti Hamalainen # Date 1298898589 -7200 # Node ID de37c79098cc4e9822c49dc97e8da0814f827777 # Parent 481fa6487a24f5a2edd371872b975e83758a3331 Updated documentation. diff -r 481fa6487a24 -r de37c79098cc docs/manual.sgml --- a/docs/manual.sgml Mon Feb 28 14:31:45 2011 +0200 +++ b/docs/manual.sgml Mon Feb 28 15:09:49 2011 +0200 @@ -405,7 +405,7 @@ -
Mercurial-repository +
Development version Another way to get GgrTF is to go to the very source, the development source repository. This repository contains the latest @@ -418,7 +418,7 @@ -New features and new bugfixes may sometimes be worth taking the risk. +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. @@ -434,7 +434,7 @@ GgrTF's Mercurial repository is graciously hosted by &jeskko; at &pupuneturl;, and is available from following location: &hgrepourl;. -The same URL can be used with a web browser to browse the repository history. +The same URL can be used with a web browser to browse version history.
Checking out @@ -459,6 +459,25 @@ hg clone &hgrepourl; ~/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 &hgrepourl; "C:\Documents and Settings\Ggr\ggrtf\" + + +Under Windows Vista and 7, the path is of the format C:\Users\<username>\ + +
Keeping up to date @@ -468,17 +487,12 @@ the following commands: -cd ~/ggrtf -hg pull -hg update - - -If you have made changes to the files, Mercurial will try to merge them -with changes that have occured in the main repository. Sometimes the -changes may be interfering with each other and cause a merging error. -You must fix these problems by hand, please refer to Mercurial -documentation for more information and tips. - +cd ~/ggrtf + +hg pull + +hg update + Notice that since Mercurial is a distributed version management system, you can easily @@ -486,6 +500,12 @@ 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. + +
@@ -549,7 +569,9 @@ DruWare Win32 port of TF: - + Windows XP/2k/NT - C:\Documents and Settings\username\tfrc, + + Windows 7/Vista - C:\Users\username\tfrc