HoverRace Subversion
The HoverRace project uses Subversion for version control. As with most svn projects, the current main code is found under trunk/ and experimental branches (which may or may not have been merged back into trunk) can be found in branches/. Source code for releases can be found under tags/.
Getting a copy
From the command line, the following command can be used to check out the source from svn:
svn co svn://svn.igglybob.com/hoverrace/trunk/
However, if you are on Windows, it is more likely you're using a tool like TortoiseSVN. To check out the code with TortoiseSVN, right-click in the directory you want to check out the source to and select 'SVN Checkout' (assuming TortoiseSVN is integrated with Explorer, which it is by default). For the repository URL, you should enter svn://svn.igglybob.com/hoverrace/trunk/ and select to check out the HEAD revision (that is, the newest revision).
Once that is all complete, the next step is to set up the DevEnvironment correctly.
Checking in code and svn etiquette
When you have made a change or fixed a bug, and want to commit your code to the repository, you will need to have an svn account. To prevent vandalism we unfortunately do not allow checkins from anyone; as a result to create an account, just contact one of the other developers and they will get you set up with one.
When you do check in code, please try to follow the guidelines below:
- Don't break the build! - if your code does not compile under the standard development environment, then it shouldn't be checked in yet! Make sure it all works before you check it in.
- Smaller changes are better - one commit that fixes 50 bugs makes it more difficult for people looking at the code diffs to understand which changes fix which bugs.
- Meaningful log entries - it is useful to document what your new code actually does in the revision log.
- Consistent formatting - try to follow the HoverRaceCodingStandards if possible.
Don't be scared though -- if you break the rules, nobody is going to send you death threats. Unfortunately, as much as we might like to believe so, the future of the world does not revolve around whether the HoverRace trunk builds or not.
