Difference between revisions of "Source Setup"

From Tales of Maj'Eyal
Jump to: navigation, search
(Linux)
(Git (Mirror): This no longer seems to be available. I'm not sure what to do with this section.)
 
(10 intermediate revisions by 7 users not shown)
Line 1: Line 1:
You can access the ToME source code using Subversion or Git.  (ToME's Subversion repository is the official version, although the Git repository offers several advantages.)
+
You can access the official ToME source code using Git.  (Note: the official source repository was in Subversion until June 7, 2013.)
  
== Subversion ==
+
The source is also available from the downloads page at [https://te4.org/download te4.org]. '''NOTE:''' this option is useful if you want the version without music
  
=== Short version ===
+
== Git ==
  
(if you're already familiar with Subversion)
+
The Git repository is available at http://git.net-core.org/groups/tome read-only to everyone.
  
* URL: http://svn.net-core.org/repos/t-engine4
+
In Linux/Unix, after installing Git:
* Username: guest
+
git clone http://git.net-core.org/tome/t-engine4.git
* Password: guestor
+
  
=== Windows Details ===
+
This will create a directory named '''t-engine4''' inside the current working directory.
  
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:
+
If you need a Git client for Windows, you can download [https://code.google.com/p/tortoisegit/ TortoiseGit] or [http://www.sourcetreeapp.com/ SourceTree].
  
http://svn.net-core.org/repos/t-engine4
+
=== Git Basics ===
  
A second dialog box will pop up, asking for a username and password. Use these:
+
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.
  
* Username: guest
+
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:
* Password: guestor
+
  
=== OS X ===
+
* Retrieve all new changes:
 
+
git fetch origin
Use a Mac Subversion client of your choice, or use the Linux command-line instructions below.
+
* Review the changes before applying them:
 
+
git log -p HEAD...origin
=== Linux ===
+
* Apply the changes to your local working directory:
 
+
git merge origin
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 ==
+
  
The Git repository of ToME is available from http://git.develz.org/.
 
  
If you need a Git client for Windows, you can download [https://code.google.com/p/tortoisegit/ TortoiseGit].
+
== Git (Mirror) ==
 +
 +
The original Git repository was restored (and was updating every 10m) and was available from http://git.develz.org/. This site is still up, but it now says "404 - No projects found".

Latest revision as of 10:12, 20 May 2022

You can access the official ToME source code using Git. (Note: the official source repository was in Subversion until June 7, 2013.)

The source is also available from the downloads page at te4.org. NOTE: this option is useful if you want the version without music

Git

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

In Linux/Unix, after installing Git:

git clone http://git.net-core.org/tome/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 or SourceTree.

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


Git (Mirror)

The original Git repository was restored (and was updating every 10m) and was available from http://git.develz.org/. This site is still up, but it now says "404 - No projects found".