documentation update

CONFIG.md

@@ -330,3 +330,9 @@ Replaces `RTS` stubbed routines implementation with one causing a break.
 ### `CONFIG_DBG_PRINTF`
 
 Makes `printf` routine available.
+
+## Other options
+
+### `CONFIG_COMPRESSION_LVL_2`
+
+Adds additional step in compressing BASIC interpreter strings - a dictionary compression. Not tested extensively - and for now it won't bring any improvement (it will even increase the code/data size) as we do not have enough strings yet to make this method useful. Do not use!

README.md

@@ -4,6 +4,7 @@ A project to create unencumbered open-source ROMs for use on selected retro comp
 
 * [implementation status](./STATUS.md) of various APIs and functionalities
 * [configuration options](./CONFIG.md) for those willing to compile their own, customized ROM set
+* [BASIC extensions](doc/Extended-BASIC.md)
 * [development guide](./doc/Development.md) for those interested in OpenROMs technical aspects
 * [license](./LICENSE) information and list of major contributors
 * [credits](./CREDITS.md) to people whose work was of great help to us

STATUS.md

@@ -10,6 +10,7 @@ Here are the features of the Open ROMs not found in the original ROMs from the 8
 
 * JiffyDOS and DolphinDOS protocols support
 * DOS wedge (direct mode only) - `@<drive_number>`, `@<command>`, `@$`, `@$<params>`, `@`
+* BASIC extensions, see the [documentation](doc/Extended-BASIC.md) 
 
 * turbo tape load support (as device 7, or using `←L`), quite sophisticated: up to 250 blocks (can store bytes under I/O), automatically adjusts for tape speed differences
 * normal tape load error log is limited by free stack space only (no artificial limitation like in original ROMs)

c64/,,config_custom.s

@@ -145,4 +145,4 @@
 
 // Other
 
-// #define CONFIG_COMPRESSION_LVL_2         // work on this option stopped - for now it has no chance to improve anything
+// #define CONFIG_COMPRESSION_LVL_2

c64/,,config_cx16.s

@@ -136,3 +136,7 @@
 
 // #define CONFIG_DBG_STUBS_BRK
 // #define CONFIG_DBG_PRINTF
+
+// Other
+
+// #define CONFIG_COMPRESSION_LVL_2

c64/,,config_generic.s

@@ -134,3 +134,7 @@
 
 // #define CONFIG_DBG_STUBS_BRK
 // #define CONFIG_DBG_PRINTF
+
+// Other
+
+// #define CONFIG_COMPRESSION_LVL_2

c64/,,config_mega65.s

@@ -134,3 +134,7 @@
 
 // #define CONFIG_DBG_STUBS_BRK
 // #define CONFIG_DBG_PRINTF
+
+// Other
+
+// #define CONFIG_COMPRESSION_LVL_2

c64/,,config_testing.s

@@ -134,3 +134,7 @@
 
 // #define CONFIG_DBG_STUBS_BRK
 #define CONFIG_DBG_PRINTF
+
+// Other
+
+// #define CONFIG_COMPRESSION_LVL_2

c64/,,config_ultimate64.s

@@ -134,3 +134,7 @@
 
 // #define CONFIG_DBG_STUBS_BRK
 // #define CONFIG_DBG_PRINTF
+
+// Other
+
+// #define CONFIG_COMPRESSION_LVL_2

doc/Extended-BASIC.md

@@ -0,0 +1,30 @@
+
+# Extended BASIC
+
+NOTE: Command syntax, behaviour details, and tokens are still subject to change! In the future most (if not all) extended commands will be available only on machines with extended ROM, like the Mega65.
+
+## Additional commands
+
+### `FAST`
+
+Tries to switch the machine to turbo mode - details differ depending on the configured machine / motherboard.
+
+### `SLOW`
+
+Tries to switch the machine back to 1 MHz operation mode.
+
+### `MERGE "file_name" [, device_number]`
+
+Appends the BASIC program from a storage medium to the one currently present in memory. NOTE: due to bug in BASIC editor (improper VARTAB handling) it currently works only with programs loaded from the storage medium, not the ones typed in!
+
+### `BLOAD "file_name", device_number, start_address`
+
+Loads a binary file starting from the given memory location. Does not clear variables, does not perform BASIC program relinking, etc. NOTE: for now syntax differs from the BASIC V3.5+ - this will be changed once the necessary BASIC infrastructure is implemented.
+
+### `BVERIFY "file_name", device_number, start_address`
+
+Verify operation for the binary data starting from a given addres. NOTE: for now syntax differs from the BASIC V3.5+ - this will be changed once the necessary BASIC infrastructure is implemented.
+
+### `BSAVE "file_name", device_number, start_address, end_address`
+
+Saves the binary data from the given memory area. NOTE: for now syntax differs from the BASIC V3.5+ - this will be changed once the necessary BASIC infrastructure is implemented.