forked from bobek/aranym-debian
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
112 lines (76 loc) · 3.37 KB
/
INSTALL
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.