X-Git-Url: http://git.localhorst.tv/?a=blobdiff_plain;f=readme;h=e10a6c39c103eb0517587407ac1e2d3e52d7fe13;hb=HEAD;hp=6bb9cb09a0fee76b6c4f1c60aed053d519a8ac4f;hpb=fc8a43f3745e7f3808e29b90a2fa9a958ecaf29b;p=l2e.git diff --git a/readme b/readme index 6bb9cb0..e10a6c3 100644 --- a/readme +++ b/readme @@ -3,14 +3,50 @@ About Its long-term goal is feature-completeness with Lufia 2. Quickstart - cd Release; make all; cd ..; ./Release/l2e test-data/*.l2s + cd build/release; make all; ./l2e ../../test-data/*.l2s Building To build the binary, simply enter the desired build configuration directory - (currently `Release' or `Debug') and execute `make all`. + in `build' (currently `release' or `debug') and execute `make all`. + + The supplied `config.mk' includes `local-config.mk' should it exist. + This can be used to adjust the build configuration to your environment + without messing with files tracked by git. + + All built files can be removed via the `clean' make target. + + There are a number of silent includes in the makefiles should you need to + override any settings. + * Global build settings can be adjusted in `/build/local-config.mk'. + * Settings specific to building the l2e binary should go into + `/build/l2e-local.mk'. + * Build confiuration specific settings should go into + `/build/$config/local.mk', e.g. `/build/debug/local.mk'. + + Unit tests can be built with `make tests' and run with `make test'. + If a unit test should fail for you, please file a bug at + http://luke.redirectme.net/redmine/projects/l2e/issues/new and describe + * your architecture and operating system, + * versions of the libs, + * and which test(s) failed. + Patches are also welcome :) + +Dependencies + Runtime + * SDL + * SDL_image + Building with make and supplied configuration + * g++ + * find + * make + * pkg-config + * and a number of core utilities such as rm, mkdir, and an sh-compatible + shell. + Building and running unit tests + * cppunit Launching - The current version required huge amounts of symbols to be defined and does + The current version requires huge amounts of symbols to be defined and does not automatically load anything. There are some data files in the `test-data' directory that provide exactly what's needed to run. @@ -19,6 +55,18 @@ Launching By default, main() will launch a map scene. This can be changed to a battle scene by passing `-B'. +Control Mapping + pad up : W | action A : right + pad right : D | action B : down + pad down : S | action X : up + pad left : A | action Y : left + start : return | debug 1 : 1 + select : space | debug 2 : 2 + right : right shift | debug 3 : 3 + left : left shift | debug 4 : 4 + + This mapping is defined in `src/keys.h'. + More There is a project page online with issue tracker and wiki at `http://luke.redirectme.net/redmine/projects/l2e'.