Difference between revisions of "Working with the development version"

From VDrift
Jump to: navigation, search
(Added a few more git commands.)
Line 8: Line 8:
  
 
===Linux/Unix===
 
===Linux/Unix===
Install a git ([http://git-scm.com/ Git]) client. If you are using a Linux distribution you can search for it in the package manager. When you have installed it you need to open a terminal and run the following code:  
+
Install a git client (eg. [http://git-scm.com/ Git]). If you are using a Linux distribution you can search for it in the package manager. When you have installed it you need to open a terminal and run the following code:  
 
 
 
  git clone git://github.com/VDrift/vdrift.git vdrift
 
  git clone git://github.com/VDrift/vdrift.git vdrift
 
+
It will download the current development version in the subfolder vdrift. Next, [[Getting_the_development_version#Checking_out_the_data|check out the data]].
It will download the current development version in the subfolder vdrift. Next, [[Getting_the_development_version#Checking_out_the_data|check out the data]].
 
  
 
===Windows===
 
===Windows===
The best solution for Windows is to download [http://code.google.com/p/msysgit/ MSysGit]. After installing it, open Windows explorer and go to the directory where you want to download the VDrift development version. Right-click and click Git GUI Here. Select Open Existing Repository. In the next screen you need to fill in the URL of the repository which is git://github.com/VDrift/vdrift.git. Simply click OK, and the development version will be downloaded. Next, [[Getting_the_development_version#Checking_out_the_data|check out the data]].
+
The best solution for Windows is to download [http://code.google.com/p/msysgit/ MSysGit]. After installing it, open Windows Explorer and go to the directory to which you want to download the VDrift development version. Right-click and click Git GUI Here. Select Open Existing Repository. In the next screen you need to fill in the URL of the repository which is git://github.com/VDrift/vdrift.git. Simply click OK, and the development version will be downloaded. Next, [[Getting_the_development_version#Checking_out_the_data|check out the data]].
  
 
===Mac OS X===
 
===Mac OS X===
This is the same as working with [[Getting_the_development_version#Linux/Unix|Linux/Unix]] however you will need to obtain a git client.  
+
This is the same as working with [[Getting_the_development_version#Linux/Unix|Linux/Unix]] however you will need to obtain a git client (eg. [http://mac.github.com/ GitHub for Mac]).
 
Once you have a working SVN client see the [[Getting_the_development_version#Linux/Unix|Linux/Unix]] instructions.
 
Once you have a working SVN client see the [[Getting_the_development_version#Linux/Unix|Linux/Unix]] instructions.
  
 
==Checking out the data==
 
==Checking out the data==
The data set is currently only available from the SourceForge SVN. Get it from https://vdrift.svn.sourceforge.net/svnroot/vdrift/vdrift-data to the vdrift/data from svn.vdrift.net. If you are using a command-line SVN client and have the VDrift repository checked out in a directory called /home/user/code, you would do this:
+
The data set is currently only available from the SourceForge SVN ([https://vdrift.svn.sourceforge.net/svnroot/vdrift/vdrift-data]). It needs to be checked out in a ''/data'' directory in the main vdrift directory. If you are using a command-line SVN client and have the VDrift repository checked out in a directory called ''/home/user/vdrift'', you would do this:
  cd /home/user/code
+
  cd /home/user/vdrift
 
  svn co https://vdrift.svn.sourceforge.net/svnroot/vdrift/vdrift-data data
 
  svn co https://vdrift.svn.sourceforge.net/svnroot/vdrift/vdrift-data data
If you are using the Tortoise SVN client, see the documentation on the Tortoise SVN [http://tortoisesvn.tigris.org/ website] for more information on how to check out a repository.
 
  
 
==Working with the repository==
 
==Working with the repository==
 +
See this documentation for more info: http://help.github.com/
 +
 +
===Making your own changes===
 +
If you want to make your own changes to improve VDrift, the easiest way is to fork the main VDrift repo on GitHub (https://github.com/VDrift/vdrift/). Just click the button near the top right of the page. You will need a free GitHub account.
 +
Then clone your new repo onto your computer:
 +
git clone git@github.com:''username''/vdrift.git
 +
And link this to the original VDrift repo:
 +
git remote add upstream git://github.com/octocat/Spoon-Knife.git
 +
git fetch upstream
 +
 
===Updating===
 
===Updating===
 
Once the reposotory has been checked out, it can be updated without downloading the entire thing again. For command line git, use the command
 
Once the reposotory has been checked out, it can be updated without downloading the entire thing again. For command line git, use the command
 
  git pull
 
  git pull
 
to check for updates and apply them.
 
to check for updates and apply them.
 +
If you have made some changes, use the following to prevent these being lost:
 +
git fetch upstream
 +
git merge upstream/master
 +
 +
===Uploading changes===
 +
To upload any changes you've made, first add the files to the commit:
 +
git add ''filename''
 +
Then do the commit:
 +
git commit -m 'Commit message'
 +
And finally send this to GitHub:
 +
git push origin master
  
 
===Checking in changes===
 
===Checking in changes===
 
You can request a VDrift developer to incorporate your changes by initiating a GitHub pull request. See this documentation for more info: http://help.github.com/send-pull-requests/
 
You can request a VDrift developer to incorporate your changes by initiating a GitHub pull request. See this documentation for more info: http://help.github.com/send-pull-requests/
  
===Adding and removing files===
 
Every file you introduce to the checkout on your computer is not automatically added to the repository. First you must add it:
 
git add ''filename''
 
Where ''filename'' is the file you wish to add. Similarly you may remove files that are no longer needed with <code>git rm ''filename''</code>.
 
  
 +
Thank you for helping make VDrift better for everyone!
  
 
[[Category:Development]]
 
[[Category:Development]]

Revision as of 13:45, 3 July 2011

VDrift's code is kept in a Git repository on GitHub. To get the development version, you must "check out" the code from this repository.

Browsing the repositories

VDrift's source on the GitHub web site is at https://github.com/VDrift/vdrift/. Here you may browse the VDrift repositories and even download single files. This is very useful for examining changes between different revisions, in a user-friendly manner.

Checking out the code

If you want to do much work on VDrift you'll need to check out an entire copy of the development tree.

Linux/Unix

Install a git client (eg. Git). If you are using a Linux distribution you can search for it in the package manager. When you have installed it you need to open a terminal and run the following code:

git clone git://github.com/VDrift/vdrift.git vdrift

It will download the current development version in the subfolder vdrift. Next, check out the data.

Windows

The best solution for Windows is to download MSysGit. After installing it, open Windows Explorer and go to the directory to which you want to download the VDrift development version. Right-click and click Git GUI Here. Select Open Existing Repository. In the next screen you need to fill in the URL of the repository which is git://github.com/VDrift/vdrift.git. Simply click OK, and the development version will be downloaded. Next, check out the data.

Mac OS X

This is the same as working with Linux/Unix however you will need to obtain a git client (eg. GitHub for Mac). Once you have a working SVN client see the Linux/Unix instructions.

Checking out the data

The data set is currently only available from the SourceForge SVN ([1]). It needs to be checked out in a /data directory in the main vdrift directory. If you are using a command-line SVN client and have the VDrift repository checked out in a directory called /home/user/vdrift, you would do this:

cd /home/user/vdrift
svn co https://vdrift.svn.sourceforge.net/svnroot/vdrift/vdrift-data data

Working with the repository

See this documentation for more info: http://help.github.com/

Making your own changes

If you want to make your own changes to improve VDrift, the easiest way is to fork the main VDrift repo on GitHub (https://github.com/VDrift/vdrift/). Just click the button near the top right of the page. You will need a free GitHub account. Then clone your new repo onto your computer:

git clone git@github.com:username/vdrift.git

And link this to the original VDrift repo:

git remote add upstream git://github.com/octocat/Spoon-Knife.git
git fetch upstream

Updating

Once the reposotory has been checked out, it can be updated without downloading the entire thing again. For command line git, use the command

git pull

to check for updates and apply them. If you have made some changes, use the following to prevent these being lost:

git fetch upstream
git merge upstream/master

Uploading changes

To upload any changes you've made, first add the files to the commit:

git add filename

Then do the commit:

git commit -m 'Commit message'

And finally send this to GitHub:

git push origin master

Checking in changes

You can request a VDrift developer to incorporate your changes by initiating a GitHub pull request. See this documentation for more info: http://help.github.com/send-pull-requests/


Thank you for helping make VDrift better for everyone!