git @ Cat's Eye Technologies linapple / 956eda9
Merge branch 'master' of https://github.com/catseye/linapple into set-resource-dir-at-build-time Chris Pressey 4 years ago
3 changed file(s) with 64 addition(s) and 34 deletion(s). Raw diff Collapse all Expand all
0 # LinApple #
1 ## Command-line fork ##
2
3 This is a fork of the LinApple Apple ][e emulator for Linux. This fork allows certain options to be specified from the command line when running LinApple.
4
5 Currently, the following command line options are available:
6
7 * -d1: Specifies a disk image to load into FDD1 (drive 0)
8 * -d2: Specifies a disk image to load into FDD1 (drive 1)
9 * -f: Specifies that the emulator should run in fullscreen mode
10 * -b : Specifies that benchmark should be loaded
11 * -l: Logs output to a file called AppleWin.log
12 * -m: Disables direct sound
13 * -autoboot: Boots the system automatically, rather than displaying the splash screen
14
15 When specifying disk images, the full path should be used (e.g. `linapple -d1 /home/myname/disks/MYSTHOUS.DSK`
16
17 Currently, only the options to specify disks start in fullscreen, and auto boot have been tested.
18
19 This fork is far from perfect, and has not been tested extensively. The main purpose is to allow users to set up custom shell scripts which they may use to automatically load
20 certain Apple ][ games or programs with the click of a button. While this need is met by this fork, extensive testing has not been performed to ensure new bugs were not
21 introduced by these changes.
22
23 A simple script can be set up to run an Apple ][ game or program by combining the -d1, -f, and -autoboot options, for example:
24
25 linapple -d1 /path/to/disk/image -f -autoboot
26
27 ### TODO ###
28
29 1. Testing is needed to make sure the other command line options are working correctly. Currently, only the -d1, -d2, and -f options have been tested.
30 2. Extensive testing is needed to ensure that these changes have not inadvertently broken other features of the program. Unfortunately, a test suite did not come with the
31 original code, so I have not been able to test this.
32 3. Add a command line switch which allows the user to specify different configuration files.
33
0 This is Cat's Eye Technologies' fork of linapple, an Apple II emulator
1 for Linux. It is based on AppleWin by Tom Charlesworth and others,
2 ported to Linux by Krez beom beotiger. The original README can be found
3 below, following the line of equals signs in this file.
4
5 The objective of this fork is to make a version of linapple which is
6 "properly unixy" instead of being a perfunctory translation of a
7 Windows app. This includes:
8
9 - autobooting from a disk image name on the command line. This
10 work comes from a branch by @arloduff and is documented in another
11 file in this directory: Command-line.md
12 - recording location of resource files at build time instead of
13 assuming they always reside in the current directory. This permits
14 the executable to be started from any directory (under development)
15 - treating the configuration file as read-only (planned)
16
17 It also contains changes for building and running under OSX, taken from
18 other forks of linapple on Github, however, keeping these changes tested
19 and working is not a priority for this fork.
20
21 This code was forked from the version that @timob branched from Sourceforge,
22 which is ostensibly version 2.0. It has incorporated several changes
23 from around Github since them. It does not yet have a specific version
24 number, but when it does, it will likely be something like 2.0ce1.
25
26 -Chris
27
28 =====================================================================
29
030 *** LINAPPLE 2.0***
131
232 [INTRO]
+0
-34
Readme.md less more
0 # LinApple #
1 ## Command-line fork ##
2
3 This is a fork of the LinApple Apple ][e emulator for Linux. This fork allows certain options to be specified from the command line when running LinApple.
4
5 Currently, the following command line options are available:
6
7 * -d1: Specifies a disk image to load into FDD1 (drive 0)
8 * -d2: Specifies a disk image to load into FDD1 (drive 1)
9 * -f: Specifies that the emulator should run in fullscreen mode
10 * -b : Specifies that benchmark should be loaded
11 * -l: Logs output to a file called AppleWin.log
12 * -m: Disables direct sound
13 * -autoboot: Boots the system automatically, rather than displaying the splash screen
14
15 When specifying disk images, the full path should be used (e.g. `linapple -d1 /home/myname/disks/MYSTHOUS.DSK`
16
17 Currently, only the options to specify disks start in fullscreen, and auto boot have been tested.
18
19 This fork is far from perfect, and has not been tested extensively. The main purpose is to allow users to set up custom shell scripts which they may use to automatically load
20 certain Apple ][ games or programs with the click of a button. While this need is met by this fork, extensive testing has not been performed to ensure new bugs were not
21 introduced by these changes.
22
23 A simple script can be set up to run an Apple ][ game or program by combining the -d1, -f, and -autoboot options, for example:
24
25 linapple -d1 /path/to/disk/image -f -autoboot
26
27 ### TODO ###
28
29 1. Testing is needed to make sure the other command line options are working correctly. Currently, only the -d1, -d2, and -f options have been tested.
30 2. Extensive testing is needed to ensure that these changes have not inadvertently broken other features of the program. Unfortunately, a test suite did not come with the
31 original code, so I have not been able to test this.
32 3. Add a command line switch which allows the user to specify different configuration files.
33