comparison README @ 615:bd664a9bd863

get license and readme.
author Robert McIntyre <rlm@mit.edu>
date Tue, 26 Feb 2013 11:28:45 +0000
parents
children b90c645dac33
comparison
equal deleted inserted replaced
614:b531d490859c 615:bd664a9bd863
1 This is vba-clojure, by Robert McIntyre (rlm@mit.edu).
2
3 It is three things:
4
5 - vba-rerecording (http://code.google.com/p/vba-rerecording/),
6 modified compile on GNU/Linux, as well as JNI bindings.
7
8 - A functional clojure interface to the emulator supported by JNI
9 bindings.
10
11 - The "Pokemon Yellow Total Control Hack" code
12 (http://aurellem.org/vba-clojure/html/total-control.html), which
13 uses the clojure bindings.
14
15
16 * License
17
18 vba-rerecording is licensed under the GPL version 2, and I also
19 release all the code I have written relating to this project under the
20 GPL version 2.
21
22 NOTE that the images under the /font directory and the mid files in
23 the /music directory were taken from http://www.zophar.net/ and
24 http://www.everyponysings.com/ respectively and are the only things in
25 this repository that are not under the GPL.
26
27
28 * How to Compile
29
30 ** Long version
31
32 Compilation follows 5 steps:
33
34 1. Get java libraries
35 2. Generate java JNI header and bindings
36 3. generate autotools scripts
37 4. configure
38 5. make
39
40 First, run the dl-libs.sh script to download the tritonus jars (or
41 otherwise obtain them), which are used in processing sound from the
42 gameboy. You must have wget installed for the dl-libs.sh to work.
43
44 Second, you must generate the java JNI header and bindigs. cd to the
45 "java" directory and run `ant` to do this.
46
47 Third, generate the autotools scripts which the project requires by
48 running `autoreconf -i`. I use autoreconf version 2.69.
49
50 Fourth, run the "configure" script that was just produced to check for
51 dependencies and proper environment variables. Be sure to have the
52 environment variables JAVA_INCLUDE_PATH and JAVA_INCLUDE_PATH2
53 properly defined. "jni.h" should be in the directory referenced by
54 JAVA_INCLUDE_PATH, and "jni_md.h" should be in the directory
55 referenced by JAVA_INCLUDE_PATH2. On my system,
56 JAVA_INCLUDE_PATH=/usr/include and
57 JAVA_INCLUDE_PATH2=/usr/include/linux.
58
59 finally, run `make` to build the library. You may optionally install
60 the library using `make install`.
61
62 ** Short Version
63
64 ./dl-libs.sh
65 cd java
66 ant
67 cd ..
68 autoreconf -i
69 ./configure
70 make
71 make install
72
73
74
75