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
## 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
## Copyright (C) 2002-2004 The ScummVM project
@ -177,7 +177,7 @@ install: all
$(INSTALL) -d "$(DESTDIR)$(DATADIR)/icons"
$(INSTALL) -c -m 644 "$(srcdir)/src/common/stella.xpm" "$(DESTDIR)$(DATADIR)/icons"
$(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)
install-strip: install
strip stella$(EXEEXT)
@ -197,7 +197,7 @@ win32dist: stella$(EXEEXT)
rm -rf $(DISTNAME)
mkdir -p $(DISTNAME)/docs/graphics
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 -r docs/*.html $(DISTNAME)/docs
cp -r docs/graphics/*.png $(DISTNAME)/docs/graphics
@ -250,7 +250,7 @@ gp2x-organize:
mkdir -p "$(srcdir)/gp2x/docs"
cp -v $(srcdir)/stella $(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 -r $(srcdir)/docs/* $(srcdir)/gp2x/docs

View File

@ -16,7 +16,8 @@ Warlords graphics bug fixed
Joystick fixed
Phosphor effect enabled
>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
SOUND!
Diagonals
@ -31,19 +32,22 @@ Joy mouse skips menu items.
------------------------------
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:
---------------------
Place files stella, stella.gpe, and stella.pro into a chosen directory. Upon first run, Stella will ask for your
ROM directory and snapshot directory. Remember that the path to the sd card is '/mnt/sd'.
Place files stella and stella.gpe into a chosen directory. Upon first run,
Stella will ask for your ROM directory and snapshot directory. Remember that
the path to the sd card is '/mnt/sd'.
-----------
Navigation:
-----------
The joystick moves the mouse cursor in all menus except the ROM Launcher, 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
The joystick moves the mouse cursor in all menus except the ROM Launcher,
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.
-------------
@ -58,28 +62,38 @@ GP2X Mapping:
START = Launcher Menu
SELECT = Command Menu
Note: Nothing has been taken away by changing this mapping. Save, Change, and Load State are all available
through the Command Menu (SELECT).
Note: Nothing has been taken away by changing this mapping. Save, Change, and
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
to change the settings (as we all do) and happen to cause a crash or hang, delete the 'stellarc' file and that should
clear up 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.
Caution: Changing video and audio settings could lead to a non-working Stella
setup. If you do feel the need to change the settings (as we all do) and happen
to cause a crash or hang, delete the 'stellarc' file and that should clear up
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:
-------------
Since the GP2X branch was so graciously added to Stella, GP2X compilation is now built in. If you plan on doing a
compile yourself, you need the GP2X devkit pro and SDL Open2X libs with zlib support. I recommend theoddbot's
Open2X libraries which work very nicely for this. Any questions, email me.
Since the GP2X branch was so graciously added to Stella, GP2X compilation is
now built in. If you plan on doing a compile yourself, you need the GP2X devkit
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:
export PATH=<your arm-linux compiler path>:$PATH
This is what my configure line looks like:
./configure --prefix=<your destination folder> --enable-zlib --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>
./configure
--prefix=<your destination folder>
--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:
make
@ -89,16 +103,19 @@ make gp2x-strip
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
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:
---------------
... to Steve Anthony for the major improvements in the port and incorporating the GP2X. Not to mention the
wealth of information and help... did I mention patience? ;-)
... to Steve Anthony for the major improvements in the port and incorporating
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 the Stella Team for the excellent emulator and the hospitality.
... 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.
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 also need the stella.pro file. Also create a subdirectory called
"Roms" (without the quotes, of course). You should place your rom files
there. You can run Stella now.
Also create a subdirectory called "Roms" (without the quotes, of course).
You should place your rom files there. You can run Stella now.
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
to half an hour. Be patient. You can transfer the stella.cache file