Updated Readme.md file to reflect these changes.
Arlo Duff authored 7 years ago
T. Joseph Carter committed 4 years ago
10 | 10 | * -b : Specifies that benchmark should be loaded |
11 | 11 | * -l: Logs output to a file called AppleWin.log |
12 | 12 | * -m: Disables direct sound |
13 | * -autoboot: Boots the system automatically, rather than displaying the splash screen | |
13 | 14 | |
14 | 15 | When specifying disk images, the full path should be used (e.g. `linapple -d1 /home/myname/disks/MYSTHOUS.DSK` |
15 | 16 | |
16 | Currently, only the options to specify disks and start in fullscreen have been tested. | |
17 | Currently, only the options to specify disks start in fullscreen, and auto boot have been tested. | |
17 | 18 | |
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 |
19 | 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 |
20 | 21 | introduced by these changes. |
21 | 22 | |
22 | If you specify a disk image for drive 0, LinApple will automatically boot from that disk, rather than showing the splash screen on startup. This will, in turn, cause it | |
23 | not to load the configuration file, so you will always start with the default configuration settings if you use this option. This is probably the best option for now, | |
24 | since LinApple updates the configuration file to its current settings when it closes, which you probably don't want it to do if you're creating autoload scripts with these | |
25 | command line options. By not loading a configuration file, we effectively stop it from updating that file when it closes. | |
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 | 26 | |
27 | 27 | ### TODO ### |
28 | 28 | |
29 | 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 | 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 | 31 | original code, so I have not been able to test this. |
32 | 3. Currently, specifying the -d1 option causes the program to throw a Segmentation Fault if the user tries to change disks during gameplay. This can most likely be addressed | |
33 | by setting the Slot 6 property when the -d1 option is given. Slot 6 is typically set by the configuration file, which is what led to this problem. | |
34 | 4. Modify the code to load the configuration file even if the -d1 option is specified. | |
35 | 5. Add a command line switch which allows the user to specify different configuration files. | |
32 | 3. Add a command line switch which allows the user to specify different configuration files. | |
36 | 33 |