X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=docs%2FINSTALL;h=c81b0a5d3f2041e74e16cae1c26189c6a7ef8bda;hb=5b056aa1b8278aff14df2dacb5df2787d2eb8bdf;hp=6947f494406d1fc1c66c89d904f1fb36dde6a927;hpb=f45b4acc547ca85d9af9efa37d8caa68c20a42e6;p=virtualjaguar diff --git a/docs/INSTALL b/docs/INSTALL index 6947f49..c81b0a5 100644 --- a/docs/INSTALL +++ b/docs/INSTALL @@ -1,5 +1,5 @@ ---------------------------------------- -Virtual Jaguar v2.0.0 Qt release INSTALL +Virtual Jaguar v2.1.1 Qt release INSTALL ---------------------------------------- @@ -11,16 +11,12 @@ The minimum requirements for compiling Virtual Jaguar from source are: o GCC v4.4.x or higher o SDL v1.2.14 or higher o zlib v1.2.5 - o libcdio v0.82 or higher (optional, for Jaguar CD support) + o libcdio v0.90 or higher (optional, for Jaguar CD support) o OpenGL libraries - o Qt 4.7.3 or higher + o Qt 4.7.3 or higher (but not Qt 5!) o supported OS (BeOS, Linux, FreeBSD and WIN32 through mingw, MacOS); other OSs may work to but you may need to change some items in the Makefile. -Optionally you'll need an Atari Jaguar boot ROM (and/or CD boot ROM) which is -available on the Internet. We can't include the boot ROM since it's still -copyrighted. - COMPILING: ---------- @@ -31,15 +27,49 @@ decompressed the source: make -Optionally you can manually strip vj[.exe] to downsize the binary. If you have -upx in your path somewhere, you can uncomment the line in the makefile that -executes upx so that you'll end up with a somewhat smaller binary. +Optionally you can manually strip virtualjaguar[.exe] to downsize the binary. +You can also run upx on the binary as well and you'll end up with a somewhat +smaller binary. + +That's it! You can now start the emulator with ./virtualjaguar. See the built +in help (Help|Contents) for more info. + +For even more info, go to http://icculus.org/virtualjaguar. + + +NOTES FOR COMPILING UNDER MAC OSX: +---------------------------------- + +All is not well in Appleland, but we can help. Apple, in their infinite wisdom, +has decided not to ship a compiler and tools to build software. So first of all +you need to download and install 'Command Line Tools for XCode'. Then, to +compile the bare minimum app under OSX requires libsdl and Qt; however, these +must be made statically and installed "the unix way". What that means is you +have to download and unpack the source directories, then make and install them +from the terminal. For libsdl, this is as simple as doing: + +./configure +make +sudo make install + +libsdl makes both static *and* shared libs and installs both. Making Qt takes a +bit longer (timewise), but requires not much user intervention to get things +going. Basically, you do: + +./configure -static -no-webkit -no-qt3support -no-framework -no-exceptions -nomake examples -nomake demos +make +sudo make install + +Be forewarned that it will use around 20 GB of disk space to build, and another +20 GB for the install! Once libsdl and Qt have been made and installed, you can +now go into the folder where the Virtual Jaguar source is and do: + +make -That's it! You can now start the emulator with ./virtualjaguar. See the output -for more details (or stdout.txt on Win32) or consult the README file for more -info. +Assuming all went well, you should now have a nice shiny new virtualjaguar.app +in that folder. Depending on how old your copy of OSX is, you might have to +copy a qt_menu.nib into the app bundle like so: -For even more info, go to http://sdlemu.ngemu.com or send use an e-mail to the -following e-mail address: sdlemu AT ngemu DOT com. +cp -r ~/location-where-you-built-qt/src/gui/mac/qt_menu.nib virtualjaguar.app/Contents/Resources/ -SDLEMU +Have fun!