Difference between revisions of "Source Setup"

From Tales of Maj'Eyal
Jump to: navigation, search
(Removed SVN part, if people *really* want to know they can check the history)
Line 27: Line 27:
 
''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.''
 
''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) ==
+
== Git (Mirror) ==
 
+
=== Short version ===
+
 
+
(if you're already familiar with Subversion)
+
 
+
* URL: http://svn.net-core.org/repos/t-engine4
+
* Username: guest
+
* Password: guestor
+
 
+
=== Windows Details ===
+
 
+
Download and install [http://tortoisesvn.net/ 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:
+
 
+
<code>
+
  $ cd
+
  $ mkdir tomedev
+
  $ cd tomedev
+
</code>
+
 
+
Download the bleeding edge source, and hope it's not bug free. :)
+
 
+
<code>
+
  $ svn checkout --username guest --password guestor http://svn.net-core.org/repos/t-engine4
+
</code>
+
 
+
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) ==
+
  
 
The original Git repository is restored (updates every 10m) and is available from http://git.develz.org/.
 
The original Git repository is restored (updates every 10m) and is available from http://git.develz.org/.

Revision as of 13:06, 13 June 2013

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.

Git (Mirror)

The original Git repository is restored (updates every 10m) and is available from http://git.develz.org/.