summaryrefslogtreecommitdiff
path: root/docs/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'docs/INSTALL')
-rw-r--r--docs/INSTALL/linux.txt124
-rw-r--r--docs/INSTALL/win32.txt75
2 files changed, 199 insertions, 0 deletions
diff --git a/docs/INSTALL/linux.txt b/docs/INSTALL/linux.txt
new file mode 100644
index 00000000..54d775bd
--- /dev/null
+++ b/docs/INSTALL/linux.txt
@@ -0,0 +1,124 @@
+How to compile and install TMW on my GNU/Linux Box
+==================================================
+
+Author: Alexander Baldeck (aka kth5)
+Email: kth5@cboxx.de
+Homepage: alex.cboxx.de
+
+The Mana World project
+======================
+Homepage: themanaworld.sourceforge.net
+IRC: irc.freenode.net / #manaworld
+
+1) Requirements
+2) Installing the Allegro library
+3) Installing the Alfont library
+4) Installing the JGmod library
+5) Installing The Mana World
+6) Notes
+
+1. Requirements
+===============
+
+First of all you need a working installation of your favorite GNU/Linux
+distribution. I recommend Debian Sarge/Sid or ArchLinux but you won't listen
+to what i say anyway, eh? ;-)
+
+Second you need to have a working version of GCC with the C and C++ compiler
+available. Simply run this to test your if it is installed:
+ For the C compiler: gcc -v
+ For the C++ compiler: g++ -v
+
+Both should state a version and other stuff, if not found install them
+both first. Those should be included in any distribution.
+
+To get The Mana World to compile, some libraries are needed:
+
+1) Allegro 4.1+
+2) Alfont 1.91
+3) JGmod 0.99
+
+2) Installing the Allegro Libraries
+===================================
+
+Look for a package for the distribution you run first and if you find a
+version of Allegro 4.1 or higher you can save the time to go through the
+next steps and skip to section 3. If not read ahead!
+
+Download Allegro:
+ http://prdownloads.sourceforge.net/alleg/allegro-4.1.14.tar.gz?download
+
+Follow the steps:
+1) cd into the path you donwloaded the tarball to
+2) run "tar xzf allegro-4.1.14.tar.gz"
+3) cd into "allegro-4.1.14"
+4) run "./configure && make"
+5) then make sure you are the superuser and run "make install"
+6) run "ldconfig -v | grep allegro"
+ This should output exaclty one line:
+ "/usr/local/lib/allegro/4.1:"
+ If not check where it was installed to and add the path to your ld
+ config file and run the above command again.
+
+Allegro should now be installed on your system. If libraries are missing
+or something else doesn't work out please correspond to Allegros installation
+manual:
+ http://alleg.sourceforge.net/
+
+3) Installing the Alfont library
+================================
+
+This is most likely not included in any distribution out there. So download
+the source from here:
+ http://nekros.freeshell.org/delirium/alfont.php
+
+1) extract the archive, i recommend unzip :-)
+2) cd into the directory
+3) edit "Makefile" so it looks like this:
+
+ [..]
+ # Makefile for AllegroFont using FreeType 2
+
+ # select (uncomment) one target and comment DJGPP if you are not aiming
+ # for that platform
+ #TARGET=DJGPP_STATIC
+ #TARGET=MINGW32_STATIC
+ #TARGET=MINGW32_DLL
+ TARGET=LINUX_STATIC
+ [..]
+4) run "sh fixunix.sh"
+5) run "make"
+6) make sure you're the superuser and do the following:
+ cp lib/linux/libalfont.a /usr/lib
+ cp include/* /usr/include
+ ldconfig
+7) this should finish the Alfont installation
+
+4) Installing the JGmod library
+TODO
+
+5. Installing The Mana World
+============================
+
+The final step... I assume you have already downloaded the latest tarball
+or checked out a recent version from the CVS. In any case follow the last
+3 steps:
+
+1) cd into the directory you have extracted the source to
+2) run a simple "make"
+3) This should have been it! Now you should be able to run "./ManaWorld"
+ and play the game. If not you are welcome to post your questions on
+ the TMW forums:
+ http://themanaworld.sourceforge.net/phpBB2/index.php
+
+6. Notes
+========
+
+I only tested this on Archlinux Current (13th July 2004) and Debian Sid
+(13th July 2004) with the most recent packages installed.
+
+If you have any comments regarding this installation howto feel free to
+contact me using the stated email-address on the top of this document.
+But please try the TMW IRC channel first.
+
+That's all folks! Have a nice day! :-)
diff --git a/docs/INSTALL/win32.txt b/docs/INSTALL/win32.txt
new file mode 100644
index 00000000..921e0e4e
--- /dev/null
+++ b/docs/INSTALL/win32.txt
@@ -0,0 +1,75 @@
+How to compile and install TMW on my Win32 Box
+==============================================
+
+Author: Alexander Baldeck (aka kth5)
+Email: kth5@cboxx.de
+Homepage: alex.cboxx.de
+
+The Mana World project
+======================
+Homepage: themanaworld.sourceforge.net
+IRC: irc.freenode.net / #manaworld
+
+0. Index
+========
+1. Requirements
+2. Installing Dev-C++
+3. Updating Dev-C++ and Allegro installation
+6. Installing The Mana World
+7. Notes
+
+1. Requirements
+===============
+
+In this tutorial we will use DevC++ b/c of the fact that
+it's a free and one of best - if not THE best - IDE you
+can get on Win32. Remember, Win32 was not meant for GCC
+and stuff so you will probably run into trouble unless
+you really know what you're doing, so best stick with
+Dev-C++.
+
+Furthermore TMW depends on the following libraries:
+
+1) Allegro 4.1.x
+2) Alfont 1.91
+3) JGmod 0.99
+
+
+2. Installing Dev-C++
+=====================
+
+I recommend that you get the latest stable version. Though
+this tutorial is written for and tested w/ Dev-C++ 4.9.90
+it may also apply to any later version. Get 4.9.90 here:
+
+ http://prdownloads.sourceforge.net/dev-cpp/devcpp4990setup.exe
+
+After you fetched it simply run and install. As soon as it is
+installed you need to adjust a couple of enviroment-variables.
+I will assume that you know how to do this.
+
+If you have Dev-C++ installed to "C:\Dev-Cpp" - the default -
+your envars should contain these:
+
+SET PATH=C:\Dev-Cpp\bin;C:\otherpaths
+SET MINGDIR=C:\Dev-Cpp
+
+Don't worry this won't hurt your Win32 unless you replace the
+contents of PATH. ;-)
+
+
+3. Updating Dev-C++ and Allegro installation
+=====================
+
+Since the GCC in Dev-C++ is pretty old, we should get something
+newer. This - fortunately - is not very hard to do. Simply fo to
+"Tools" and then to "Check for Upgrades/Packages".
+This will give you the Webupdate dialog where you should click
+on the "Check for upgrades" button.
+When you see the list look for "g++-3.4.1" and "gcc-core-3.4.1"
+in the group "Dev-C++ MINGW System". After you have done that,
+select the group you might want to check out a group called
+"Allegro"! ;-)
+
+
+TODO \ No newline at end of file