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