create /ramdisk on boot

Author: braindigitalis

cmake/custom_targets.cmake

@@ -68,7 +68,7 @@ function(copy_config TARGETFILE SOURCEFILE)
     set(FILENAME "${CMAKE_SOURCE_DIR}/${SOURCEFILE}")
     set(OUTNAME "${CMAKE_BINARY_DIR}/iso/${TARGETFILE}")
     add_custom_command(OUTPUT ${OUTNAME}
-        COMMAND mkdir -p "${CMAKE_BINARY_DIR}/iso/harddisk" && mkdir -p "${CMAKE_BINARY_DIR}/iso/boot" && mkdir -p "${CMAKE_BINARY_DIR}/iso/devices" && mkdir -p "${CMAKE_BINARY_DIR}/iso" && cp ${FILENAME} ${OUTNAME}
+        COMMAND mkdir -p "${CMAKE_BINARY_DIR}/iso/harddisk" && mkdir -p "${CMAKE_BINARY_DIR}/iso/ramdisk" && mkdir -p "${CMAKE_BINARY_DIR}/iso/boot" && mkdir -p "${CMAKE_BINARY_DIR}/iso/devices" && mkdir -p "${CMAKE_BINARY_DIR}/iso" && cp ${FILENAME} ${OUTNAME}
         DEPENDS ${FILENAME})
     add_custom_target(config_${TARGETFILE} ALL DEPENDS ${OUTNAME})
     add_dependencies("kernel.bin" config_${TARGETFILE})

docpages/images/firstboot.png

@@ -5,6 +5,7 @@ Welcome to Retro Rocket! This guide is for everyone who wants to use the system,
 - \subpage introduction
 - \subpage system-requirements
 - \subpage getting-started
+- \subpage installation
 - \subpage desktop-and-shell
 - \subpage file-system
 - \subpage commands

docpages/user-guide/07_INDEX.md

@@ -11,5 +11,22 @@ This section will guide you through starting Retro Rocket for the first time.
 Retro Rocket will load directly from the CD. You don’t need to install anything to your hard disk to try it out.
 
 ### First screen
-After a short load you will see some diagnostics, and then arrive at the **command shell prompt**:
+After a short load you will see some diagnostics and an image of our mascot, *Rocky*, and then arrive at the **command shell prompt**:
 
+\image html firstboot.png
+
+
+This is where you type commands.
+
+### First commands to try
+- `dir` — lists the contents of the current directory.
+- `about` — loads and runs the BASIC program called `about`
+
+### Saving your work
+When running from the LiveCD, Retro Rocket automatically creates a **1 GB RAM disk**.
+- It is mounted at `/ramdisk`.
+- Save your BASIC programs there while experimenting.
+- Files in the RAM disk are lost when you shut down or restart.
+
+### Installing to hard disk
+If you want to keep your work permanently, you can install Retro Rocket to a SATA or NVMe hard disk. See the @ref installation "Installation" section for details.

docpages/user-guide/getting-started.md

@@ -10,6 +10,9 @@ MOUNT "/boot", "hd0", "fat32"
 PROCmessage("Setting", "keymap")
 KEYMAP "qemu"
 
+RD$ = EMPTYRAMDISK$(1024)
+MOUNT "/ramdisk", RD$, "rfs"
+
 SPRITELOAD rocky,"/images/boot.png"
 PLOT rocky, GRAPHICS_WIDTH - 128 - 16, 8
 SCROLLREGION 0, 16