remove outdated information from linux readme (address #35)
This commit is contained in:
parent
8aa066dffc
commit
e487193545
|
@ -1,77 +1,50 @@
|
|||
DeSmuME
|
||||
_________________________________________
|
||||
Copyright (C) 2006 yopyop
|
||||
Copyright (C) 2006-2007 DeSmuME team
|
||||
|
||||
DeSmuME is written in C++ using the GTK+ and SDL libraries.
|
||||
|
||||
1) Compiling instructions...................................13
|
||||
2) How to use DeSmuME.......................................53
|
||||
3) Contact information......................................142
|
||||
4) Disclaimer...............................................160
|
||||
|
||||
|
||||
1 Compiling instructions______________________________________
|
||||
|
||||
DeSmuME is written in C using the gtk+ and SDL libraries.
|
||||
So you need a working C compiler, such as gcc and
|
||||
the following libraries runtime and development packages:
|
||||
|
||||
* http://www.gtk.org
|
||||
|
||||
* http://www.libsdl.org/
|
||||
|
||||
Once these libraries are installed, you should be ready to
|
||||
install DeSmuME.
|
||||
* http://www.gtk.org
|
||||
* http://www.libsdl.org/
|
||||
|
||||
DeSmuME provides another interface based on libglade, to use
|
||||
it, you'll need glade:
|
||||
, you'll need glade:
|
||||
|
||||
* http://glade.gnome.org/
|
||||
* http://glade.gnome.org/
|
||||
|
||||
1.1 From a release archive____________________________________
|
||||
To build, cd to src/frontend/posix and then run ./configure && make
|
||||
|
||||
Uncompress the DeSmuME archive, move to the newly created
|
||||
directory, type "./configure", then "make".
|
||||
It will generate three programs:
|
||||
1) "desmume" in the "src/gtk" directory;
|
||||
2) "desmume-cli" in the "src/cli" directory.
|
||||
1) "desmume" in the "gtk" directory;
|
||||
2) "desmume-cli" in the "cli" directory.
|
||||
|
||||
If glade is installed on your system, you'll get a third
|
||||
binary:
|
||||
3) "desmume-glade" in the "src/gtk-glade" directory.
|
||||
|
||||
3) "desmume-glade" in the "gtk-glade" directory.
|
||||
|
||||
You can even type "make install" to install those programs on
|
||||
your system (in /usr/local/ by default), then uninstalling is
|
||||
your system (in /usr/local/ by default); then uninstalling is
|
||||
done by typing "make uninstall".
|
||||
|
||||
1.2 From a CVS copy___________________________________________
|
||||
For more information on the available commandline options,
|
||||
check the other README files which will be more up to date.
|
||||
|
||||
Move to the toplevel directory (the one that contains the
|
||||
configure.ac file). Type "./autogen.sh" to generate the
|
||||
configure/install scripts and needed Makefiles. Then you can follow the
|
||||
same procedure as in 1.1 . intltoolize is required for the
|
||||
autogen stage:
|
||||
|
||||
* http://freedesktop.org/wiki/Software/intltool/
|
||||
|
||||
2 How to use DeSmuME__________________________________________
|
||||
|
||||
There are three versions of DeSmuME under Linux. These are a
|
||||
Gtk+ build, a Glade build and a CLI SDL build. All these builds
|
||||
have some common command line options:
|
||||
The following options specially are available on these posix ports:
|
||||
|
||||
--disable-limiter Disables the 60 fps limiter
|
||||
--soft-convert Use software colour conversion during OpenGL
|
||||
screen rendering. May produce better or worse
|
||||
frame rates depending on hardware.
|
||||
|
||||
--arm9gdb=PORT_NUM Enable the ARM9 GDB stub on the given port
|
||||
--arm7gdb=PORT_NUM Enable the ARM7 GDB stub on the given port
|
||||
The following options specially are available on the Gtk+ port:
|
||||
|
||||
--cflash=PATH_TO_DISK_IMAGE
|
||||
Enable disk image GBAMP compact flash emulation
|
||||
--opengl-2d Enables using OpenGL for screen rendering
|
||||
--disable-sound Disables the sound emulation
|
||||
--disable-3d Disables the 3D emulation
|
||||
|
||||
--help Display this message
|
||||
The following options specially are available on the CLI port:
|
||||
|
||||
--opengl-2d Enables using OpenGL for screen rendering
|
||||
--disable-sound Disables the sound emulation
|
||||
|
||||
NOTE:
|
||||
The Gtk+ and Glade builds use gtkGLext to handle the OpenGL
|
||||
|
@ -80,100 +53,4 @@ also passing the argument --gdk-gl-force-indirect. This has
|
|||
been seen to improve things for Nvidia based graphics cards
|
||||
under Linux.
|
||||
|
||||
|
||||
GDB Debugger Stubs:
|
||||
Source level debugging of ARM9 and/or ARM7 code is supported
|
||||
using a GDB/Insight debugger.
|
||||
The GDB stubs are enabled from the command line using the
|
||||
following options:
|
||||
|
||||
--arm9gdb=<PORT_NUM> (for the ARM9)
|
||||
--arm7gdb=<PORT_NUM> (for the ARM7)
|
||||
|
||||
The PORT_NUM is the TCP port upon which the stub will listen for
|
||||
connections. Once enabled you can connect to the stub using the
|
||||
following command at the GDB debugger prompt (assuming GDB and
|
||||
DeSmuME are running on the same machine):
|
||||
|
||||
target remote :<PORT_NUM>
|
||||
|
||||
NOTE: there are problems with the ARM support when stepping code
|
||||
with GDB versions prior to version 6.6. It is recommended that
|
||||
you use at least version 6.6 if possible.
|
||||
|
||||
|
||||
GBAMP compact flash emulation:
|
||||
|
||||
The default behaviour of DeSmumME is to attempt to emulate the
|
||||
FAT image for the contents of the directory where the running
|
||||
.nds file was located.
|
||||
This behaviour can be altered using the
|
||||
--cflash=<DISK_IMAGE_FILE> command line option. Using this
|
||||
option DeSmuME will emulation a GBAMP and read and write sectors
|
||||
from/to the disk image file.
|
||||
The disk image file must be created and populated with files
|
||||
using some external tool.
|
||||
NOTE: currently if desmume fails to open the disk image file it
|
||||
will silently continue minus a working GBAMP emulation.
|
||||
|
||||
|
||||
2.1 Gtk+ version______________________________________________
|
||||
|
||||
Type "desmume" in a shell, a window should appear, then open
|
||||
a rom file using the "open" button, next use the "run" button
|
||||
to start emulation.
|
||||
|
||||
The following command line options are specific to the Gtk+
|
||||
build:
|
||||
|
||||
--opengl-2d Enables using OpenGL for screen rendering
|
||||
--disable-sound Disables the sound emulation
|
||||
--disable-3d Disables the 3D emulation
|
||||
|
||||
|
||||
2.2 CLI SDL version_______________________________________________
|
||||
|
||||
Just type "desmume-cli path-to-a-rom" in a shell.
|
||||
|
||||
The following command line options are specific to the CLI
|
||||
build:
|
||||
|
||||
--opengl-2d Enables using OpenGL for screen rendering
|
||||
--disable-sound Disables the sound emulation
|
||||
|
||||
|
||||
3 Contact information_________________________________________
|
||||
|
||||
General inquiries should go to:
|
||||
E-mail: guillaume@desmume.org
|
||||
|
||||
Linux Port-related inquiries should go to:
|
||||
E-mail: guillaume@desmume.org
|
||||
|
||||
Web: http://desmume.org
|
||||
|
||||
Please don't ask for roms, bios files or any other copyrighted
|
||||
stuff.
|
||||
|
||||
If you want to submit a bug report, please run desmume, go into
|
||||
the "Help" menu, and click on "Submit a bug report". If you're
|
||||
having trouble with it, please feel free to email.
|
||||
|
||||
|
||||
4 Disclaimer__________________________________________________
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License along
|
||||
with this program; if not, write to the Free Software Foundation, Inc.,
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
|
||||
See the GNU General Public License details in COPYING.
|
||||
Visit us on the web at http://www.desmume.org
|
||||
|
|
Loading…
Reference in New Issue