Source Setup

From Tales of Maj'Eyal
Revision as of 14:20, 9 June 2013 by Greycat (Talk | contribs) (Git)

Jump to: navigation, search

You can access the official ToME source code using Git. (Note: the official source repository was in Subversion until June 7, 2013. The old Subversion information will be kept on this page for a while, but you should ignore it unless there's a problem with the new Git repository.)

Git

The Git repository is available at http://git.net-core.org/public read-only to everyone.

In Linux/Unix, after installing Git:

git clone http://git.net-core.org/darkgod/t-engine4.git

This will create a directory named t-engine4 inside the current working directory.

If you need a Git client for Windows, you can download TortoiseGit.

Git Basics

A local Git repository is a complete mirror of the "origin" repository. It includes every revision of every file, all the commit messages, and so on.

If you're only going to retrieve changes from DarkGod's repository, and never make any changes of your own, then you can get by with the following commands:

  • Retrieve all new changes:
git fetch origin
  • Review the changes before applying them:
git log -p HEAD...origin
  • Apply the changes to your local working directory:
git merge origin

DarkGod still hasn't added revision tags to the repository, so there is currently no way to work with anything but the bleeding edge development code. This is still a work in progress -- both this document, and DarkGod's Git repository.

Subversion (Deprecated)

Short version

(if you're already familiar with Subversion)

Windows Details

Download and install TortoiseSVN. It's a shell extension, so you may need to reboot when this is done. After you've rebooted your computer, make a directory somewhere where you can find it, like "C:\tomedev". Using Windows Explorer, navigate to this folder and right-click in the empty space where there isn't anything there yet, and select "SVN Checkout..." to give you TortiseSVN's checkout dialog box. In the blank URL text box, put in the following address and click OK, presuming you haven't changed any of the default settings:

http://svn.net-core.org/repos/t-engine4

A second dialog box will pop up, asking for a username and password. Use these:

  • Username: guest
  • Password: guestor

OS X

Use a Mac Subversion client of your choice, or use the Linux command-line instructions below.

Linux

Install subversion (your distribution may call it by a different name, possibly svn).

Make a directory to plop t-engine into:

 $ cd
 $ mkdir tomedev
 $ cd tomedev

Download the bleeding edge source, and hope it's not bug free. :)

 $ svn checkout --username guest --password guestor http://svn.net-core.org/repos/t-engine4

Should see a bunch of stuff filling up the directory, whee! Read How to compile to build the game.

Now get to work, and fix some bugs for us. :)

Git (Deprecated)

An unofficial Git repository (which mirrored the Subversion repository?) of ToME is (was?) available from http://git.develz.org/.