doc updates for forthcoming release

This commit is contained in:
Dagen Brock 2017-01-21 18:52:08 -06:00
parent 03438cdb39
commit f13461190a
3 changed files with 46 additions and 24 deletions

View File

@ -130,7 +130,7 @@ package-win32:
- cp /bin/cygstdc++-6.dll . - cp /bin/cygstdc++-6.dll .
- cp /bin/cygwin1.dll . - cp /bin/cygwin1.dll .
- cp /bin/cygfreetype-6.dll . - cp /bin/cygfreetype-6.dll .
artifacts: artifacts:
paths: paths:
- gsplus32.exe - gsplus32.exe
@ -142,7 +142,7 @@ package-win32:
- cyggcc_s-1.dll - cyggcc_s-1.dll
- cygstdc++-6.dll - cygstdc++-6.dll
- cygwin1.dll - cygwin1.dll
- cygfreetype-6.dll - cygfreetype-6.dll
build-win-sdl: build-win-sdl:
tags: tags:
@ -171,7 +171,8 @@ package-win-sdl:
- cp /bin/cygfreetype-6.dll . - cp /bin/cygfreetype-6.dll .
- cp /bin/cygbz2-1.dll . - cp /bin/cygbz2-1.dll .
- cp /bin/cygpng16-16.dll . - cp /bin/cygpng16-16.dll .
- cp /bin/cygz.dll .
artifacts: artifacts:
paths: paths:
- gsplus.exe - gsplus.exe
@ -183,6 +184,7 @@ package-win-sdl:
- cyggcc_s-1.dll - cyggcc_s-1.dll
- cygstdc++-6.dll - cygstdc++-6.dll
- cygwin1.dll - cygwin1.dll
- cygfreetype-6.dll - cygfreetype-6.dll
- cygbz2-1.dll - cygbz2-1.dll
- cygpng16-16.dll - cygpng16-16.dll
- cygz.dll

Binary file not shown.

View File

@ -1,8 +1,9 @@
gsp_icon_512.png doc/gsplusmanual.pdfgsp_icon_512.png
GSplus GSplus
Modern cross-platform Apple IIgs emulator and tools based on KEGS & GSPort Modern cross-platform Apple IIgs emulator and tools based on KEGS & GSPort
Manual Versions: Manual Versions:
Beta Release: 2017-01-21
Alpha Release: 2016-11-02 Alpha Release: 2016-11-02
Alpha Draft: 2016-10-27 Alpha Draft: 2016-10-27
Initial Draft: 2016-05-01 Initial Draft: 2016-05-01
@ -36,26 +37,29 @@ ________________
Emulator Hot-Keys Emulator Hot-Keys
There are several keys used to interact with the emulator while it is running. Heres a quick list of the main hot-keys and what they do. There are several keys used to interact with the emulator while it is running. Heres a quick list of the main hot-keys and what they do.
F4 - Configuration menu F4 - configuration menu - set lots of options here!
F5 - Paste from host OS into emulator F5 - paste from host OS into emulator
Shift-F5 - Screenshot F6 - toggle system speed (1, 2.8, 8, ∞ MHz )
F6 - Toggle System Speed (1, 2.8, 8, ∞ MHz ) F7 - toggle fast disk emulation
F7 - Toggle Fast Disk Emulation F9 - invert paddles
F9 - Invert Paddles F10 - toggle a2vid_palette (?)
F10 - Toggle a2vid_palette (?) F11 - toggle fullscreen mode *
F11 - Toggle Fullscreen Mode F12 - hit RESET (e.g. - to do “Ctrl-Reset” on an Apple II, you hit “Ctrl-F12”)
F12 - RESET Key (so to hit “Ctrl-Reset” on an Apple II, you hit “Ctrl-F12”) Shift-F5 - take a screenshot *
Shift-F10 - toggle status line *
Shift-F11 - toggle simulated scanlines *
* not available on all platforms
Other Input/Output Other Input/Output
1. Mouse and keyboard should automatically work 1. Mouse and keyboard should automatically work
2. Joystick with SDL2 driver is known to be working. It simply uses the “first” joystick and the first analog pad on that stick plus the first two buttons. The axes and buttons are not yet configurable. Better info forthcoming. 2. Joystick with SDL2 driver is known to be working. It simply uses the “first” joystick and the first analog pad on that stick plus the first two buttons. The axes and buttons are not yet configurable. Better info forthcoming.
3. There are drivers for serial controller, ImageWriter (II?) printer, and networking. I may have broken some of this functionality to get builds working. Im not currently familiar with the state of these drivers or their usage. More info will be added as I take time to research more of the modules. 3. There are drivers for serial controller, ImageWriter (II?) printer, and networking. I may have broken some of this functionality to get builds working. Im not currently familiar with the state of these drivers or their usage. More info will be added as I take time to research more of the modules.
4. You can also drag-and-drop disk images onto the emulator window and it will try to automount the disk! (SDL versions)
Configuration Menu Configuration Menu
Configuration options are loaded from, and saved to, a configuration text file. The default configuration file is config.txt. If you are just starting out, its recommended to use the configuration menu versus editing the file yourself. Configuration options are loaded from, and saved to, a configuration text file. The default configuration file is config.txt. If you are just starting out, its recommended to use the configuration menu versus editing the file yourself.
Enter the configuration menu at any time while running GSplus by hitting <F4>. Enter the configuration menu at any time while running GSplus by hitting <F4>.
Screen Shot 2016-05-01 at 9.10.00 AM.png Screen Shot 2016-05-01 at 9.10.00 AM.png
Most importantly, you can use the Disk Configuration menu option to “mount” and “eject” disks. Most importantly, you can use the Disk Configuration menu option to “mount” and “eject” disks. There is also
Command-line Options Command-line Options
This is from source, some are experimental and not all may be built on your system. This is from source, some are experimental and not all may be built on your system.
-badrd Halt on bad reads -badrd Halt on bad reads
@ -81,13 +85,11 @@ This is from source, some are experimental and not all may be built on your syst
-config value Set config file to value -config value Set config file to value
-debugport value Set debugport to value -debugport value Set debugport to value
-ssdir value Set screenshot save directory to value -ssdir value Set screenshot save directory to value
-scanline Enable scanline simulator
-noscanline Disable scanline simulator (default)
Note: The final argument, if not a flag, will be tried as a mountable device. Note: The final argument, if not a flag, will be tried as a mountable device.
Debugger Commands - BROKEN!!! Debugger Commands - BROKEN!!!
Sorry, the debugger is currently broken due to a change in debugging frameworks. Sorry, the debugger is currently broken due to a change in debugging frameworks.
The documentation below is accurate, but does not currently work. The documentation below is accurate, but does not currently work.
@ -96,8 +98,6 @@ GSplus CLI Debugger help (courtesy Fredric Devernay)
General command syntax: [bank]/[address][command] General command syntax: [bank]/[address][command]
e.g. 'e1/0010B' to set a breakpoint at the interrupt jump pt e.g. 'e1/0010B' to set a breakpoint at the interrupt jump pt
Enter all addresses using lower-case. As with the IIgs monitor, you can omit the bank number after having set it: 'e1/0010B' followed by '14B' will set breakpoints at e1/0010 and e1/0014 Enter all addresses using lower-case. As with the IIgs monitor, you can omit the bank number after having set it: 'e1/0010B' followed by '14B' will set breakpoints at e1/0010 and e1/0014
g Go g Go
[bank]/[addr]g Go from [bank]/[address] [bank]/[addr]g Go from [bank]/[address]
s Step one instruction s Step one instruction
@ -136,4 +136,24 @@ Project Info
Developers inquire within :P Developers inquire within :P
Main page and full source code repository: https://github.com/digarok/gsplus Main page and full source code repository: https://github.com/digarok/gsplus
This project has a homepage at http://apple2.gs/plus/ This project has a homepage at http://apple2.gs/plus/
The homepage hosts the latest build for a variety of OSes. The homepage hosts the latest build for a variety of OSes.
Release Changelog
Version 0.13 - Jan. 22 2017
Scanline simulator
Drag-and-drop disk images and it will try to automount
Fixes and improvements to logging
Win32 icon parity with other versions
Experimental host FST support
Various bug fixes
Version 0.12s - Nov. 12, 2016
First official alpha release with packages
“S” in version is because it introduces new Socket Debugger, large effort
Version 0.11 - 2015 - 2016
Not publicly released
Features first major contribution - SDL2 driver supporting displays, sound and joysticks