File: INSTALL

package info (click to toggle)
aranym 0.9.6beta2-1
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 8,436 kB
  • ctags: 17,315
  • sloc: cpp: 72,907; ansic: 29,655; sh: 3,557; asm: 1,818; makefile: 850; perl: 500; objc: 156
file content (112 lines) | stat: -rw-r--r-- 3,448 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
1) Compilation requirements
---------------------------

For compiling ARAnyM you will need libSDL, version at least 1.2.10.
You can get it from http://www.libsdl.org/ or from your OS distribution vendor.

If you want to compile source fetched from CVS you also need
automake, libtool and autoconf (http://www.gnu.org/ or your OS vendor).

Supported platforms:

All Debian GNU/Linux platforms

and

x86          BeOS
x86          GNU/Linux
x86          MS Windows + Cygwin
x86          OpenBSD (unmaintained)
PPC          MacOS X
SGI          Irix (unmaintained)
Sun Sparc    Solaris

In progress (in alphabetical order):
m68k         FreeMiNT
x86          FreeBSD
x86          NetBSD


2) Compilation
--------------

  2-1) Unix or Linux
  ------------------
If you got the source code from CVS then type
./autogen.sh && make

If you have a source snapshot or proper ARAnyM source code release then type
./configure && make

./configure --help shows you all the compile time options.

If everything went OK you got an executable file named "aranym".


  2-2) Microsoft Windows
  ----------------------
Compilation is accomplished using the Cygwin linux-like environment
(http://www.cygwin.com/).

Details are available in tools/build-cygwin.sh.


  2-3) Apple Mac OS X
  -------------------
Go to src/Unix/darwin folder first.

If you got the source code from CVS then just type
make

If you want to configure ARAnyM for your personal needs, type 
../configure_ppc --help

Add preferred options to the CONFIGURE_OPTIONS_ppc and CONFIGURE_OPTIONS_i386 
variables at the top of Makefile inside the darwin folder. After that run make 
again.

If everything went OK, you got an executable named "ARAnyM.app" inside the
src/Unix/darwin folder.

This application expects its default configuration inside the current user's 
~/Library/Preferences/org.aranym.amcfg file. Inside that config file a path 
beginning with */ will be expanded to ~/Library/Application Support/ARAnyM.

The ARAnyM.app also supports virtual machine bundles: Put all your disk image 
files, host-fs destination folders, ROM image etc. and a properly configured
org.aranym.amcfg file into a new folder. Give that folder the extension 
".ARAnyM" or ".amvm". The Mac OS X Finder will then treat this new Folder as a 
so called bundle. Just dubble click on it and ARAnyM should start and use it.

To modify such a bundles content, in the Finder Control-click or right-click on 
it and select "Show Package Contents".   

There are also other methods of building ARAnyM for OS X. Refere also to the 
documents inside src/Unix/MacOSX.


3) Installation
---------------
You may install ARAnyM on Unix/Linux by typing 'make install' (have root
privileges as default configuration installs to /usr/local/),
or you may run the binary directly by typing ./aranym.

Next step is to obtain the operating system (TOS 4.04 or EmuTOS) and install
a harddrive. More on this in the README file. Easiest is to download
one of the 'afros' disk images (Aranym FRee OS) that contain everything
preinstalled.


4) Troubleshooting
------------------

If you compiled libSDL by yourself and installed to /usr/local/ you might
experience the following problem when running autogen.sh:

aclocal: configure.in: 835: macro `AM_PATH_SDL' not found in library

The fix is relatively easy:

export ACLOCAL_FLAGS="-I /usr/local/share/aclocal"

This helps aclocal to find the .m4 file and everything is fine then.