Cleaned up some text formatting, and removed references to stella.pro

for installation (it should no longer be included with release packages).


git-svn-id: svn://svn.code.sf.net/p/stella/code/trunk@1039 8b62c5a3-ac7e-4cc8-8f21-d9a121418aba
This commit is contained in:
stephena 2006-03-11 21:34:37 +00:00
parent 7c644f92b8
commit c7863e1f56
3 changed files with 45 additions and 29 deletions

View File

@ -13,7 +13,7 @@
## See the file "license" for information on usage and redistribution of ## See the file "license" for information on usage and redistribution of
## this file, and for a DISCLAIMER OF ALL WARRANTIES. ## this file, and for a DISCLAIMER OF ALL WARRANTIES.
## ##
## $Id: Makefile,v 1.21 2006-03-02 13:10:53 stephena Exp $ ## $Id: Makefile,v 1.22 2006-03-11 21:34:37 stephena Exp $
## ##
## Based on code from ScummVM - Scumm Interpreter ## Based on code from ScummVM - Scumm Interpreter
## Copyright (C) 2002-2004 The ScummVM project ## Copyright (C) 2002-2004 The ScummVM project
@ -177,7 +177,7 @@ install: all
$(INSTALL) -d "$(DESTDIR)$(DATADIR)/icons" $(INSTALL) -d "$(DESTDIR)$(DATADIR)/icons"
$(INSTALL) -c -m 644 "$(srcdir)/src/common/stella.xpm" "$(DESTDIR)$(DATADIR)/icons" $(INSTALL) -c -m 644 "$(srcdir)/src/common/stella.xpm" "$(DESTDIR)$(DATADIR)/icons"
$(INSTALL) -d "$(DESTDIR)$(DATADIR)/stella" $(INSTALL) -d "$(DESTDIR)$(DATADIR)/stella"
$(INSTALL) -c -m 644 "$(srcdir)/src/emucore/stella.pro" "$(DESTDIR)$(DATADIR)/stella" # $(INSTALL) -c -m 644 "$(srcdir)/src/emucore/stella.pro" "$(DESTDIR)$(DATADIR)/stella"
@echo $(PROPDIR) @echo $(PROPDIR)
install-strip: install install-strip: install
strip stella$(EXEEXT) strip stella$(EXEEXT)
@ -197,7 +197,7 @@ win32dist: stella$(EXEEXT)
rm -rf $(DISTNAME) rm -rf $(DISTNAME)
mkdir -p $(DISTNAME)/docs/graphics mkdir -p $(DISTNAME)/docs/graphics
strip stella$(EXEEXT) -o $(DISTNAME)/stella$(EXEEXT) strip stella$(EXEEXT) -o $(DISTNAME)/stella$(EXEEXT)
cp src/emucore/stella.pro $(DISTNAME) # cp src/emucore/stella.pro $(DISTNAME)
cp Announce.txt Changes.txt Copyright.txt License.txt README-PSP.txt README-SDL.txt Readme.txt Todo.txt $(DISTNAME)/docs cp Announce.txt Changes.txt Copyright.txt License.txt README-PSP.txt README-SDL.txt Readme.txt Todo.txt $(DISTNAME)/docs
cp -r docs/*.html $(DISTNAME)/docs cp -r docs/*.html $(DISTNAME)/docs
cp -r docs/graphics/*.png $(DISTNAME)/docs/graphics cp -r docs/graphics/*.png $(DISTNAME)/docs/graphics
@ -250,7 +250,7 @@ gp2x-organize:
mkdir -p "$(srcdir)/gp2x/docs" mkdir -p "$(srcdir)/gp2x/docs"
cp -v $(srcdir)/stella $(srcdir)/gp2x cp -v $(srcdir)/stella $(srcdir)/gp2x
cp -v $(srcdir)/src/gp2x/stella.gpe $(srcdir)/gp2x cp -v $(srcdir)/src/gp2x/stella.gpe $(srcdir)/gp2x
cp -v $(srcdir)/src/emucore/stella.pro $(srcdir)/gp2x # cp -v $(srcdir)/src/emucore/stella.pro $(srcdir)/gp2x
cp -v $(srcdir)/README-GP2X.txt $(srcdir)/gp2x cp -v $(srcdir)/README-GP2X.txt $(srcdir)/gp2x
cp -v -r $(srcdir)/docs/* $(srcdir)/gp2x/docs cp -v -r $(srcdir)/docs/* $(srcdir)/gp2x/docs

View File

@ -16,7 +16,8 @@ Warlords graphics bug fixed
Joystick fixed Joystick fixed
Phosphor effect enabled Phosphor effect enabled
>From 2.0.1: >From 2.0.1:
Stopped using the ROM Script (No more ROM limit. 'Single binary' zip support available.) Stopped using the ROM Script (No more ROM limit. 'Single binary' zip
support available.)
Opened up the Native GUI for use through Joymouse Emulation Opened up the Native GUI for use through Joymouse Emulation
SOUND! SOUND!
Diagonals Diagonals
@ -31,19 +32,22 @@ Joy mouse skips menu items.
------------------------------ ------------------------------
Known GP2X Performance Issues: Known GP2X Performance Issues:
------------------------------ ------------------------------
Pitfall 2 runs slow due to extra hardware emulation. (Steve foresees this being fixed in the future.) Pitfall 2 runs slow due to extra hardware emulation. (Steve foresees this
being fixed in the future.)
--------------------- ---------------------
Installation to GP2X: Installation to GP2X:
--------------------- ---------------------
Place files stella, stella.gpe, and stella.pro into a chosen directory. Upon first run, Stella will ask for your Place files stella and stella.gpe into a chosen directory. Upon first run,
ROM directory and snapshot directory. Remember that the path to the sd card is '/mnt/sd'. Stella will ask for your ROM directory and snapshot directory. Remember that
the path to the sd card is '/mnt/sd'.
----------- -----------
Navigation: Navigation:
----------- -----------
The joystick moves the mouse cursor in all menus except the ROM Launcher, with any button acting as a click. The joystick moves the mouse cursor in all menus except the ROM Launcher,
In the ROM Launcher, up/down scrolls through the ROM list and left/right selects options across the bottom, with any with any button acting as a click. In the ROM Launcher, up/down scrolls through
the ROM list and left/right selects options across the bottom, with any
button serving as a click. button serving as a click.
------------- -------------
@ -58,28 +62,38 @@ GP2X Mapping:
START = Launcher Menu START = Launcher Menu
SELECT = Command Menu SELECT = Command Menu
Note: Nothing has been taken away by changing this mapping. Save, Change, and Load State are all available Note: Nothing has been taken away by changing this mapping. Save, Change, and
through the Command Menu (SELECT). Load State are all available through the Command Menu (SELECT).
Caution: Changing video and audio settings could lead to a non-working Stella setup. If you do feel the need Caution: Changing video and audio settings could lead to a non-working Stella
to change the settings (as we all do) and happen to cause a crash or hang, delete the 'stellarc' file and that should setup. If you do feel the need to change the settings (as we all do) and happen
clear up the problem. If anyone finds any settings that give better performance in sound and gameplay, to cause a crash or hang, delete the 'stellarc' file and that should clear up
let me know and I might incorporate them into the next build. Happy tinkering. the problem. If anyone finds any settings that give better performance in
sound and gameplay, let me know and I might incorporate them into the next
build. Happy tinkering.
------------- -------------
Compile Info: Compile Info:
------------- -------------
Since the GP2X branch was so graciously added to Stella, GP2X compilation is now built in. If you plan on doing a Since the GP2X branch was so graciously added to Stella, GP2X compilation is
compile yourself, you need the GP2X devkit pro and SDL Open2X libs with zlib support. I recommend theoddbot's now built in. If you plan on doing a compile yourself, you need the GP2X devkit
Open2X libraries which work very nicely for this. Any questions, email me. pro and SDL Open2X libs with zlib support. I recommend theoddbot's Open2X
libraries which work very nicely for this. Any questions, email me.
Make sure your path includes your arm-linux compilers: Make sure your path includes your arm-linux compilers:
export PATH=<your arm-linux compiler path>:$PATH export PATH=<your arm-linux compiler path>:$PATH
This is what my configure line looks like: This is what my configure line looks like:
./configure --prefix=<your destination folder> --enable-zlib --disable-developer --host=gp2x --with-zlib-prefix=<your ./configure
gp2x zlib path> --with-png-prefix=<your gp2x png path (configure appends '/include')> --with-sdl-prefix=<your sdl config --prefix=<your destination folder>
path> --x-libraries=<your X11 libraries path> --enable-zlib
--disable-cheats
--disable-developer
--host=gp2x
--with-zlib-prefix=<your gp2x zlib path>
--with-png-prefix=<your gp2x png path (configure appends '/include')>
--with-sdl-prefix=<your sdl config path>
--x-libraries=<your X11 libraries path>
Then: Then:
make make
@ -89,16 +103,19 @@ make gp2x-strip
You should get an exec ~2mb in size. Much better than 7mb right? You should get an exec ~2mb in size. Much better than 7mb right?
To gather all necessary files into directory './stella/gp2x' for easy access, type: To gather all necessary files into directory './stella/gp2x' for easy
access, type:
make gp2x-organize make gp2x-organize
Note: /gp2x directory created in the main stella source directory (next to configure, Makefile, etc.). Note: /gp2x directory created in the main stella source directory
(next to configure, Makefile, etc.).
--------------- ---------------
Special Thanks: Special Thanks:
--------------- ---------------
... to Steve Anthony for the major improvements in the port and incorporating the GP2X. Not to mention the ... to Steve Anthony for the major improvements in the port and incorporating
wealth of information and help... did I mention patience? ;-) the GP2X. Not to mention the wealth of information and help... did I
mention patience? ;-)
... to Eckhard Stolberg for making me known to the Stella Team. ... to Eckhard Stolberg for making me known to the Stella Team.
... to the Stella Team for the excellent emulator and the hospitality. ... to the Stella Team for the excellent emulator and the hospitality.
... to theoddbot for the excellent Open2X toolchain libs. ... to theoddbot for the excellent Open2X toolchain libs.

View File

@ -11,9 +11,8 @@ Installing and Running:
First create a directory for PocketStella, and copy the executable in it. First create a directory for PocketStella, and copy the executable in it.
Get the zlib for Windows CE (use the link at the bottom of this file). Get the zlib for Windows CE (use the link at the bottom of this file).
You should extract zlibce.dll (ARM targets) into the same directory. You should extract zlibce.dll (ARM targets) into the same directory.
You also need the stella.pro file. Also create a subdirectory called Also create a subdirectory called "Roms" (without the quotes, of course).
"Roms" (without the quotes, of course). You should place your rom files You should place your rom files there. You can run Stella now.
there. You can run Stella now.
A Heads up ; PocketStella scans the rom files the first time it's run. A Heads up ; PocketStella scans the rom files the first time it's run.
Depending on the number of rom files, this may take from a few seconds Depending on the number of rom files, this may take from a few seconds
to half an hour. Be patient. You can transfer the stella.cache file to half an hour. Be patient. You can transfer the stella.cache file