Development:GIT

From Adonthell
Revision as of 18:53, 8 June 2009 by Ksterker (talk | contribs) (Development:CVS moved to Development:GIT: Adonthell is no longer kept in CVS ... we've moved to git)
Jump to navigation Jump to search

If you want to contribute code to Adonthell, you will have to get the latest version from CVS, the revision control system we're using. Information about accessing the repository can be found on our Savannah Project page, but simple instructions are replicated below.

Once you have acquired the source code and installed all dependencies you can go forward and build Adonthell.

Adonthell CVS Modules

There are a number of modules available in the repository. For developing on Adonthell you will most likely need:

  • adonthell -- the source code for the Adonthell Engine
  • tools -- the source code for the accompanying Tools
  • gfx -- the media created for official games

Mainly of historical interest are:

  • adonthell-0.3 -- the source code to the v0.3.x branch of the Adonthell Engine
  • wastesedge -- the data and media files for the Waste's Edge demo game
  • doc -- the LaTeX sources to project documentation now found here

Anonymous CVS Access

At the beginning you will only have read access to our CVS repository. Once you have contributed some code and joined our team you will be granted full access.

To obtain a working copy for any of the above modules, issue the following commands:

 cvs -z6 -d:pserver:[email protected]:/sources/adonthell co <module>

This will create a folder called <module> under your current working directory. Inside that folder, run

 cvs -z6 update -dP

from time to time to get the most recent version.

Developer CVS Access

In order to gain write access to our CVS, you'll have to be registered as a developer at Savannah and become a member of Adonthell. Then you can get a working copy of the desired module with:

 export CVS_RSH=ssh
 cvs -z6 -d:ext:<membername>@cvs.savannah.nongnu.org:/sources/adonthell co <module>

To update the working copy use

 export CVS_RSH=ssh
 cvs -z6 update -dP

For more information on how to use CVS you might want to refer to Open Source Development with CVS by Karl Fogel and Moshe Bar.