Subversion is a free/open-source version control system. That is, Subversion manages files and directories over time. A tree of files is placed into a central repository. The repository is much like an ordinary file server, except that it remembers every change ever made to your files and directories. This allows you to recover older versions of your data, or examine the history of how your data changed. In this regard, many people think of a version control system as a sort of “time machine”.
If you are using Linux, you are probably don't need more than these very short instructions.
Use svn, the Subversion command line client:
$ svn co http://svn.openmoko.org/trunk /your/path/to/your/working_copy Replace /your/path/to/your/working_copy with the actual path to the directory into which you wish to use all the GSM files. Or use a . (period) if you're already in that directory.
If your current computer doesn't have Subversion, you might want to use the repository directly to get the latest files. It's not as efficient and powerful as subversion itself, but it might help.
Use the wget tool to do it, as follow:
wget -r -np -nH --cut-dirs=1 http://svn.openmoko.org/trunk
Mac OSX Setup
Thanks to its Unix underpinnings, Mac OS X offers several ways to connect to a repository, ranging from conventional Cocoa applications to the use of a command line. Though anyone should be able to follow any of the methods listed below, users are encouraged to choose the approach that best suits their personal workflow and level of technical skills--particularly if they're using Subversion to update a live site.
Graphical User Interface (SVN Approach)
Get either SvnX, scplugin, or iSVN. Download one of them and use.
Command Line Approach
This approach requires permission to use /Applications/Utilities/Terminal.app on your Macintosh (enabled by default) and shell access to your UNIX-based hosting provider. If you do not have access to both of these components, please speak with your system administrator or choose one of the alternate approaches listed above.
Install SVN from the following Metissian Projects Package
Once SVN is installed, take the following steps to checkout the GSM sourcode from the SVN repository.
- Login to your hosting provider using Terminal.app (probably using ssh).
- Move into the directory where you want to download the GSM sourcecode, like so: cd /my/gsm/directory/
svn co http://svn.openmoko.org/trunk . Make certain there is a space between the last trailing slash and the period -- this will not work properly otherwise. Alternatively, you may get the GSM sourcecode without moving into the desired directory before (i.e., combine steps 2 and 3 together), by running the command:
svn co http://svn.openmoko.org/trunk /your/path/to/your/working_copy
Once you have initially setup SVN, you simply need to do the following for all future updates.
- cd /your/path/to/your/working_copy
- svn update
These instructions describe how to get the latest GSM sourcecode from the Subversion repository to your Windows machine using a graphical user interface application called TortoiseSVN.
Using TortoiseSVN to Download the Source Files
- Download and install TortoiseSVN.
- Create a local folder with a catchy, but meaningful, name (such as gsm_source). The folder you create here is called your "source" folder, and you should keep it because whenever you update the GSM sourcecode, this is the folder you first update via TortoiseSVN.
- Right click on the new folder and you’ll see some new options for TortoiseSVN.
- Select 'Checkout' and use the following path for the 'URL of Repository'...
Updating Your Source Folder
Complete the following steps to update your local code from the SVN repository.
- Right click on your GTA01 source folder and select Update.