Merge pull request #1128 from sonninnos/commodore-updates

Commodore updates

Author: fpscan

docs/library/puae.md

@@ -71,6 +71,8 @@ Amiga Forever and TOSEC filenames are also accepted.
 
 | Filename           | Amiga Forever             | Description                        | md5sum                           |
 |--------------------|---------------------------|------------------------------------|----------------------------------|
+| kick31034.A1000    | amiga-os-110-ntsc.rom     | Kickstart v1.1 rev 31.034 NTSC     | 0b8442c311caa54fb12ec88eaaa9facf |
+| kick32034.A1000    | amiga-os-110-pal.rom      | Kickstart v1.1 rev 32.034 PAL      | 1fa1f93d3d7b51271dd1356b8b2b45a9 |
 | kick33180.A500     | amiga-os-120.rom          | Kickstart v1.2 rev 33.180          | 85ad74194e87c08904327de1a9443b7a |
 | kick34005.A500     | amiga-os-130.rom          | Kickstart v1.3 rev 34.005          | 82a21c1890cae844b3df741f2762d48d |
 | kick37175.A500     | amiga-os-204.rom          | Kickstart v2.04 rev 37.175         | dc10d7bdd1b6f450773dfb558477c230 |
@@ -435,9 +437,7 @@ If you are using RDB HDF files, please use `0,0,0,512` instead of geometry numbe
 
 ## Core options
 
-The PUAE core has the following option(s) that can be tweaked from the core options menu. The default setting is bolded.
-
-Settings with (Restart) means that core has to be closed for the new setting to be applied on next launch.
+The PUAE core has the following option(s) that can be tweaked from the core options menu. The default setting is in bold.
 
 - **Model** [puae_model] (**auto**|A500OG|A500|A500PLUS|A600|A1200OG|A1200|A2000OG|A2000|A4030|A4040|CDTV|CD32|CD32FR)
 
@@ -461,7 +461,9 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **Show Automatic Model Options** [puae_model_options_display] (**disabled**|enabled)
 
-    Show/hide default model options (Floppy/HD/CD) for 'Automatic' model. Page refresh by menu toggle required!
+    Show/hide default model options (Floppy/HD/CD) for 'Automatic' model.
+
+    Available only when frontend 'Core Option Categories' is disabled.
 
 - **Automatic Floppy** [puae_model_fd] (A500OG|**A500**|A500PLUS|A600|A1200OG|A1200|A2000OG|A2000|A4030|A4040)
 
@@ -475,9 +477,11 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
     Default model when compact discs are launched with 'Automatic' model. Core restart required.
 
-- **Kickstart ROM** [puae_kickstart] (**auto**|aros|kick33180.A500|kick34005.A500|kick37175.A500|kick37350.A600|kick40063.A600|kick39106.A1200|kick40068.A1200|kick39106.A4000|kick40068.A4000)
+- **Kickstart ROM** [puae_kickstart] (**auto**|aros|...)
+
+    'Automatic' defaults to the most compatible version for the model. 'AROS' is a built-in replacement with fair compatibility.
 
-    'Automatic' defaults to the most compatible version for the model. 'AROS' is a built-in replacement with fair compatibility. Core restart required.
+    Kickstart ROMs are searched from 'system'. Core restart required.
 
 - **Chip RAM** [puae_chipmem_size] (**auto**|1|2|3|4)
 
@@ -644,6 +648,10 @@ Settings with (Restart) means that core has to be closed for the new setting to
     | splash | Splash (Show briefly)                 |
     | both   | Config + Splash (Wait for user input) |
 
+- **WHDLoad ButtonWait** [puae_use_whdload_buttonwait] (disabled|**enabled**)
+
+    Wait for a button press on internal loading sections if the slave supports it. Core restart required.
+
 - **WHDLoad NoWriteCache** [puae_use_whdload_nowritecache] (**disabled**|enabled)
 
     Write cache requires running the core a few frames after closing content to trigger WHDLoad quit and flush cache to disk. 
@@ -661,7 +669,7 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **Show Video Options** [puae_video_options_display] (**disabled**|enabled)
 
-    Page refresh by menu toggle required!
+    Available only when frontend 'Core Option Categories' is disabled.
 
 - **Allow PAL/NTSC Hz Change** [puae_video_allow_hz_change] (disabled|enabled|**locked**)
 
@@ -777,7 +785,7 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **Show Audio Options** [puae_audio_options_display] (**disabled**|enabled)
 
-    Page refresh by menu toggle required!
+    Available only when frontend 'Core Option Categories' is disabled.
 
 - **Stereo Separation** [puae_sound_stereo_separation] (0%|10%|20%|30%|40%|50%|60%|70%|80%|90%|**100%**)
 
@@ -899,7 +907,7 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **Show Mapping Options** [puae_mapping_options_display] (disabled|**enabled**)
 
-    Page refresh by menu toggle required!
+    Available only when frontend 'Core Option Categories' is disabled.
 
 - **Toggle Virtual Keyboard** [puae_mapper_vkbd] (**---**)
 

docs/library/vice.md

@@ -262,6 +262,8 @@ Save disks generated by the `#SAVEDISK:` keyword are automatically assigned the
     - Alternative label for the next entry
 - `<disk>.d64:<prg>`
     - Load a program instead of `"*"`
+- `<tape>.tap:<prg>:,1,1`
+    - Force non-basic tape load
 - `<disk>.d64|<label>`
     - Set a friendly name (shown in "Disc Control")
 - `<disks>.zip#<disk>.d64`
@@ -361,9 +363,7 @@ Older C64 games tend to use joystick port 1 and newer ones tend to use port 2 fo
 
 ## Core options
 
-The VICE cores have the following option(s) that can be tweaked from the core options menu. The default setting is bolded.
-
-Settings with (Restart) means that core has to be closed for the new setting to be applied on next launch.
+The VICE cores have the following option(s) that can be tweaked from the core options menu. The default setting is in bold.
 
 #### C64 (fast/accurate/SuperCPU) specific
 
@@ -395,6 +395,8 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **SuperCPU Speed Switch** [vice_supercpu_speed_switch] (disabled|**enabled**)
 
+    Normal or Turbo 20MHz.
+
 - **SuperCPU Kernal** [vice_supercpu_kernal] (**0**|1|2)
 
     JiffyDOS does not work with the internal kernal!
@@ -407,28 +409,34 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **Model** [vice_c64dtv_model] (DTV2 PAL|DTV2 NTSC|**DTV3 PAL**|DTV3 NTSC|HUMMER NTSC)
 
+    Changing while running resets the system!
+
 #### C128 specific
 
 - **Model** [vice_c128_model] (**C128 PAL auto**|C128 NTSC auto|C128 D PAL auto|C128 D NTSC auto|C128 DCR PAL auto|C128 DCR NTSC auto|C128 PAL|C128 NTSC|C128 D PAL|C128 D NTSC|C128 DCR PAL|C128 DCR NTSC)
 
-    'Automatic' switches region per file path tags.
+    'Automatic' switches region per file path tags. Changing while running resets the system!
 
 - **RAM Expansion Unit** [vice_c128_ram_expansion_unit] (**none**|128kB|256kB|512kB|1024kB|2048kB|4096kB|16384kB)
 
     Not allowed with cartridges. Changing while running resets the system!
 
 - **Video Output** [vice_c128_video_output] (**VICII**|VDC)
 
+    Can be toggled with the '40/80 DISPLAY' key (F7).
+
 - **VDC Video RAM** [vice_c128_vdc_ram] (**default**|64)
 
+    VDC memory size.
+
     | Value   | Label                 |
     |---------|-----------------------|
     | default | 16kB                  |
     | 64      | 64kB                  |
 
-- **GO64 (Restart)** [vice_c128_go64] (**disabled**|enabled)
+- **GO64** [vice_c128_go64] (**disabled**|enabled)
 
-    Start in C64 compatibility mode.
+    Start in C64 compatibility mode. Changing while running resets the system!
 
 - **JiffyDOS** [vice_jiffydos] (**disabled**|enabled)
 
@@ -457,18 +465,26 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **Model** [vice_plus4_model] (C16 PAL|C16 NTSC|**PLUS4 PAL**|PLUS4 NTSC|V364 NTSC|232 NTSC)
 
+    Changing while running resets the system!
+
 #### CBM-II specific
 
 - **Model** [vice_cbm2_model] (**610 PAL**|610 NTSC|620 PAL|620 NTSC|620PLUS PAL|620PLUS NTSC|710 NTSC|720 NTSC|720PLUS NTSC)
 
+    Changing while running resets the system!
+
 #### CBM-II 5x0 specific
 
 - **Model** [vice_cbm5x0_model] (**510 PAL**|510 NTSC)
 
+    Changing while running resets the system!
+
 #### PET specific
 
 - **Model** [vice_pet_model] (2001|3008|3016|3032|3032B|4016|4032|4032B|**8032**|8096|8296|SUPERPET)
 
+    Changing while running resets the system!
+
 #### Common
 
 - **Printer** [vice_printer] (**disabled**|enabled)
@@ -501,7 +517,7 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **Warp Boost** [vice_warp_boost] (**disabled**|enabled)
 
-    Make warp mode much faster by changing SID emulation to 'FastSID' while warping.
+    Warp mode speedup by changing SID engine to 'FastSID' while warping. Affects audio detection during warp.
 
 - **Autostart** [vice_autostart] (disabled|**enabled**|warp)
 
@@ -545,7 +561,7 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **Show Video Options** [vice_video_options_display] (**disabled**|enabled)
 
-    Page refresh by menu toggle required!
+    Available only when frontend 'Core Option Categories' is disabled.
 
 - **Pixel Aspect Ratio** [vice_aspect_ratio] (**auto**|pal|ntsc|raw)
 
@@ -573,6 +589,8 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **Color Depth** [vice_gfx_colors] (16bit|**24bit**)
 
+    Full restart required.
+
 #### Color palette options
 
 ##### VIC-II (C64, C128, CBM-II 5x0)
@@ -697,8 +715,12 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **CRTC Color Palette** [vice_cbm2_external_palette] (**default**|green|amber|white)
 
+    Native default is green.
+
 - **CRTC Color Palette** [vice_pet_external_palette] (**default**|green|amber|white)
 
+    Native default is green.
+
 ### On-Screen Display options
 
 - **Virtual KBD Theme** [vice_vkbd_theme] (**auto**|auto_outline|brown|brown_outline|beige|beige_outline|dark|dark_outline|light|light_outline)
@@ -735,7 +757,7 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **Show Audio Options** [vice_audio_options_display] (**disabled**|enabled)
 
-    Page refresh by menu toggle required!
+    Available only when frontend 'Core Option Categories' is disabled.
 
 - **Drive Sound Emulation** [vice_drive_sound_emulation] (disabled|5%|10%|15%|**20%**|25%|30%|35%|40%|45%|50%|55%|60%|65%|70%|75%|80%|85%|90%|95%|100%)
 
@@ -861,7 +883,8 @@ Settings with (Restart) means that core has to be closed for the new setting to
     | Value | Label                           |
     |-------|---------------------------------|
     | 1     | Joystick                        |
-    | 2     | Paddles                         |
+    | 2     | Paddles (Split)                 |
+    | 2R    | Paddles (Raw)                   |
     | 3     | Mouse (1351)                    |
     | 4     | Mouse (NEOS)                    |
     | 5     | Mouse (Amiga)                   |
@@ -890,7 +913,7 @@ Settings with (Restart) means that core has to be closed for the new setting to
 
 - **Show Mapping Options** [vice_mapping_options_display] (disabled|**enabled**)
 
-    Page refresh by menu toggle required!
+    Available only when frontend 'Core Option Categories' is disabled.
 
 - **Toggle Virtual Keyboard** [vice_mapper_vkbd] (**---**)