BZFlag SVN

*******NOTE******

This page is incomplete and will be filled in with proper information as soon as our CVS to SVN transition is complete.

BZFlag SVN, is the Subversion Revision Controll System used by the development team to maintain and store the BZFlag Source code. The SVN system is hosted by SourceForge and is accessible by anyone with the proper software.

SVN clients

To access the source code via SVN , you will need a SVN client. Most unix/linux type operating systems have the command line SVN client as an installable option. Windows users must download a third party SVN client, such as the Tortoise Graphical SVN Client.

Geting code from SVN Access

Command line

The simplest way to get all the bzflag source code for every module is to simply get the entire trunk

  svn co https://bzflag.svn.sourceforge.net/svnroot/bzflag bzflag

This will get all modules and subdirs. This will take a while. It is often more efficient to only get the subdir for the module you are interested in.

TortoiseSVN

Windows users that use the Tortoise Graphical SVN Client simply enter the URL of the SVN path they wish to check out in the field marked URL of repository. For the current version of all modules simply use the /trunk path. Note, if you want your code to be checked out into a new folder, be sure to enter that folder name in the Checkout directory field.

If you wish to get only a single module subdir, or a revision, simply use the URL specified in the sections bellow.

Commiting Code to SVN

Project developers that need write access to the source code to make changes ( or commits ) need to provide there sourceforge username and password when doing a SVN commit. A sourceforge account is required for developer access, as well as approval from a project administrator.

TortoiseSVN

Windows users that use the Tortoise Graphical SVN Client, should do other stuff

Updating code from SVN to the current version

svn up is your friend.

Module sub directories

The source code in SVN is broken up into a number of modules for ease of use and management. When requesting the source code from the SVN system a sub-directory may be specified to limit the code that is accessed.

The current SVN modules are:

• bzflag : The main module that includes the game client, server, plug-ins, and BZAdmin.
• admin : The Master Ban list
• bzedit : The linux version of the BZFlag map editor BZEdit
• bzeditw32 : The windows version of the BZFlag map editor BZEditWin32
• web : The main website at http://www.bzflag.org
• db : Files related to the website http://my.bzflag.org and the Global Login system.
• pybzflag : an abandoned python implementation of BZFlag

to get the current version of a module, you would add

 /trunk/MODULE_NAME

after the normal SVN URL.

so to get the current version of just the bzflag modlue, the URL would be

 https://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/bzflag/

Branches

Branches in subversion are simply subfolders. All branches are in the /branches subdirectory that if off the root level of the SVN tree. they can be viewed here, http://bzflag.svn.sourceforge.net/viewvc/bzflag/branches/ To get the code in a branch, you simply use the branch URL in your svn client.

To get the 2.0.x branch of the BZFlag module, you'd use the following URL.

  https://bzflag.svn.sourceforge.net/viewvc/bzflag/branches/v2_0branch/bzflag/

External Links

SourceForge SVN Access page

BZFlag SVN Tree